> ## Documentation Index
> Fetch the complete documentation index at: https://docs.app.strix.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List images in a connected registry

> Return up to 50 image repository names per page. Requires containers:read and an unscoped admin or analyst. Strix uses the stored credential on the server. GitHub connections list the selected package owner's images only. Older GitHub connections without account selection default to the credential username and accept a namespace override. Docker Hub defaults to the connection username or library for anonymous connections. Google Artifact Registry requires a project-id/repository namespace and artifactregistry.packages.list permission on that repository. Google filters image names before pagination and returns a native page token. Strix does not download the complete Google catalog. ECR uses ecr:DescribeRepositories. Other registries use the OCI catalog, when available. Pull access does not guarantee listing access. If listing fails, callers can still add an image by its reference.



## OpenAPI

````yaml /openapi.json get /containers/registries/{registryId}/repositories
openapi: 3.1.0
info:
  title: Strix API
  version: 1.0.0
  description: >-
    Public REST API for the Strix autonomous penetration testing platform.
    Manage scans, vulnerabilities, assets, schedules, API tokens, and webhooks.
servers:
  - url: /api/v1
    description: Strix v1 API
security:
  - BearerAuth: []
tags:
  - name: Scans
    description: Launch, monitor, and manage security scans.
  - name: Vulnerabilities
    description: View and triage discovered vulnerabilities.
  - name: Assets
    description: Domains and repositories registered for scanning.
  - name: Schedules
    description: Recurring scan schedules (Pro plan).
  - name: Search
    description: Search across issues, pentests, PR reviews, chats, assets and schedules.
  - name: Tokens
    description: Manage API tokens for authentication.
  - name: Webhooks
    description: Configure webhook subscriptions for real-time event notifications.
  - name: Organization
    description: Workspace configuration for the authenticated organization.
  - name: Members
    description: Manage organization members and roles.
  - name: Invitations
    description: List and revoke organization invitations.
  - name: PR Reviews
    description: Automated security review of pull requests.
  - name: Connectors
    description: Network connectors for scanning internal/private targets.
  - name: Knowledge
    description: >-
      Organization knowledge base: documents, policies, and repo profiles that
      steer the agent.
  - name: Uploads
    description: Upload source/code/documentation archives for whitebox scans.
  - name: Integrations
    description: Third-party integrations (GitLab, Bitbucket, ticketing).
  - name: Chat
    description: Conversational agent sessions.
  - name: Analytics
    description: Aggregate dashboard analytics.
  - name: Test Users
    description: >-
      Per-domain test accounts (with optional MFA) the agent authenticates as
      during scans.
  - name: License
    description: Self-hosted license state, entitlements, and aggregate usage.
  - name: Supply Chain
    description: >-
      SBOM inventory, supply-chain findings, scans, and policy for connected
      repositories.
  - name: CLI
    description: >-
      Device authorization endpoints that let the Strix CLI and coding agents
      sign in and receive an API token.
  - name: Billing
    description: Credit balance, agent-payable top-ups, and automatic top-up settings.
  - name: Workspaces
    description: List, create, and switch workspaces.
  - name: Asset Discovery
    description: >-
      Passive reconnaissance runs that map the organization's external attack
      surface, and the discovered-asset inventory they fill.
  - name: Containers
    description: >-
      Container registries, tracked images, image scans, findings, and SBOM
      components.
  - name: Run Logs
    description: Persisted engine logs and the diagnostics bundle of a self-hosted install.
paths:
  /containers/registries/{registryId}/repositories:
    get:
      tags:
        - Containers
      summary: List images in a connected registry
      description: >-
        Return up to 50 image repository names per page. Requires
        containers:read and an unscoped admin or analyst. Strix uses the stored
        credential on the server. GitHub connections list the selected package
        owner's images only. Older GitHub connections without account selection
        default to the credential username and accept a namespace override.
        Docker Hub defaults to the connection username or library for anonymous
        connections. Google Artifact Registry requires a project-id/repository
        namespace and artifactregistry.packages.list permission on that
        repository. Google filters image names before pagination and returns a
        native page token. Strix does not download the complete Google catalog.
        ECR uses ecr:DescribeRepositories. Other registries use the OCI catalog,
        when available. Pull access does not guarantee listing access. If
        listing fails, callers can still add an image by its reference.
      operationId: listContainerRegistryRepositories
      parameters:
        - name: registryId
          in: path
          required: true
          description: Registry ID from listContainerRegistries.
          schema:
            type: string
            format: uuid
        - name: namespace
          in: query
          description: >-
            User or organization for Docker Hub or older GitHub connections
            without account selection. For scoped GitHub connections, omit this
            parameter or use the saved github_owner. Required
            project-id/repository path for Google Artifact Registry. Google
            returns nested image names within that repository. Other providers
            ignore this parameter.
          schema:
            type: string
            maxLength: 255
        - name: cursor
          in: query
          description: >-
            The next_cursor from the previous page. Keep the same registry,
            namespace, and query. Start without a cursor when the query changes.
          schema:
            type: string
            maxLength: 4096
        - name: query
          in: query
          description: >-
            Case-insensitive image name substring for Google Artifact Registry.
            Google applies this filter before pagination. Use letters, numbers,
            periods, underscores, hyphens, and slashes. Omit this parameter to
            browse all image names. Other providers ignore this parameter.
          schema:
            type: string
            maxLength: 512
            pattern: ^[a-zA-Z0-9._/-]*$
      responses:
        '200':
          description: >-
            One page of image repository names. These names do not include a tag
            or digest.
          content:
            application/json:
              schema:
                type: object
                required:
                  - repositories
                  - next_cursor
                  - namespace
                properties:
                  repositories:
                    type: array
                    maxItems: 50
                    items:
                      type: string
                    examples:
                      - - acme/api
                        - acme/worker
                  next_cursor:
                    type:
                      - string
                      - 'null'
                    description: Pagination cursor. Null means there are no more pages.
                  namespace:
                    type:
                      - string
                      - 'null'
                    description: >-
                      The user, organization, or Google project/repository path.
                      Null for a registry-wide catalog.
        '400':
          description: >-
            Invalid parameters, unsupported catalog, or insufficient registry
            listing permissions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          description: The registry rate limited the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          $ref: '#/components/responses/InternalError'
        '502':
          description: Strix could not reach the registry.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - BearerAuth:
            - containers:read
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        detail:
          type: string
          description: Human-readable explanation of the error.
        code:
          type: string
          description: >-
            Stable machine-readable error code. `insufficient_scope` means the
            token does not hold the scope that this endpoint requires.
        required_scope:
          $ref: '#/components/schemas/ApiV1Scope'
          description: >-
            Scope that the caller must add to the token. Returned with the
            `insufficient_scope` code.
        docs:
          type: string
          format: uri
          description: Documentation page that explains how to resolve the error.
        hint:
          type: string
          description: >-
            One instruction that resolves the error. For `insufficient_scope`, a
            CLI session gets the `strix cloud session scopes set full` or `strix
            cloud login --scope-profile full` command, and an API token gets the
            settings page where the user creates a token with the scope. When
            the owner's role cannot hold the scope, the hint asks for a role
            change instead.
      required:
        - detail
    ApiV1Scope:
      type: string
      enum:
        - scans:read
        - scans:write
        - vulnerabilities:read
        - vulnerabilities:write
        - dependencies:read
        - schedules:read
        - schedules:write
        - assets:read
        - assets:write
        - organizations:read
        - organizations:write
        - members:read
        - members:write
        - invitations:read
        - invitations:write
        - webhooks:read
        - webhooks:write
        - tokens:write
        - audit:read
        - pr_reviews:read
        - pr_reviews:write
        - connectors:read
        - connectors:write
        - knowledge:read
        - knowledge:write
        - uploads:write
        - integrations:read
        - integrations:write
        - chat:read
        - chat:write
        - scans:message
        - analytics:read
        - llm:read
        - llm:write
        - test_users:read
        - test_users:write
        - discovery:read
        - discovery:write
        - license:read
        - supply_chain:read
        - supply_chain:write
        - billing:read
        - billing:write
        - containers:read
        - containers:write
        - logs:read
  responses:
    Unauthorized:
      description: Missing or invalid API token.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Forbidden:
      description: >-
        Insufficient permissions or missing scope. A missing scope returns the
        `insufficient_scope` code, the `required_scope` field, and a `hint` with
        the command or page that grants the scope, so a client can request the
        correct scope and retry.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFound:
      description: Resource not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalError:
      description: Internal server error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        API token obtained from the Tokens endpoint or CLI device login. Include
        as `Authorization: Bearer <token>`. Requests made with a managed CLI
        session also include `X-Strix-Workspace: <organization_id>` to pin a
        process to the workspace it started in; recovery endpoints report the
        current workspace after a concurrent switch.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.