openapi: 3.2.0
info:
  description: OCI Container Registry extension endpoints provide compatibility and extensions for the Docker/Open Container Initiative Distribution Registry HTTP API v2. Use together with the Artifacts and Container Images API for control‑plane repository and image management - https://docs.oracle.com/en-us/iaas/api/#/en/registry/20160918/
  license:
    name: Oracle Corporation
  title: Container Registry API
  version: '20180419'
  x-provenance:
    method: harvested
    first_party: true
    publisher: Oracle
    source: https://docs.oracle.com/en-us/iaas/api/specs/7ccfb78b3f9b220858d1ff9bf87fe9cfd8dc9018c6cd8ea7ba588a378c2e18d5.yaml
    harvested: '2026-08-04'
    note: Published by Oracle as the contract for the Container Registry API OCI service and stored verbatim; API Evangelist added only this provenance block.
  x-evidence:
  - url: https://docs.oracle.com/en-us/iaas/api/specs/index.json
    what: Oracle's own index of every OCI service specification
  - url: https://docs.oracle.com/en-us/iaas/api/specs/7ccfb78b3f9b220858d1ff9bf87fe9cfd8dc9018c6cd8ea7ba588a378c2e18d5.yaml
    what: the harvested document for Container Registry API
servers:
- url: /20180419
tags:
- name: ContainerRegistry
paths:
  /docker/token:
    get:
      description: Get a token using basic auth credentials or signature headers
      operationId: GetAccessToken
      parameters:
      - $ref: '#/components/parameters/ServiceQueryParam'
      - $ref: '#/components/parameters/ScopeQueryParam'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        200:
          description: The access token
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessToken'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
      summary: GetAccessToken
      tags:
      - ContainerRegistry
      x-related-resource: '#/definitions/AccessToken'
components:
  schemas:
    AccessToken:
      description: Access token response for OCI Container Registry extension authentication.
      properties:
        access_token:
          description: Access token string (alias for token).
          maxLength: 32768
          minLength: 1
          type: string
        expires_in:
          description: Seconds until the token expires.
          format: int32
          type: integer
        scope:
          description: Scope that restricts access to resources.
          maxLength: 1024
          minLength: 0
          type: string
        token:
          description: Access token string.
          maxLength: 32768
          minLength: 1
          type: string
      required:
      - token
      - access_token
      - scope
      - expires_in
  parameters:
    ScopeQueryParam:
      description: 'Scope to restrict access to resources.

        Example: `repository:namespace/reponame:pull,push`

        '
      in: query
      name: scope
      required: false
      x-default-description: 'null'
      schema:
        type: string
        maxLength: 1024
        minLength: 1
    ServiceQueryParam:
      description: Domain name of the target service server.
      in: query
      name: service
      required: false
      x-default-description: 'null'
      schema:
        type: string
        maxLength: 255
        minLength: 1
    RequestIdHeader:
      description: 'Unique identifier for the request.

        If you need to contact Oracle about a particular request, please provide the request ID.

        '
      in: header
      name: opc-request-id
      schema:
        type: string
        pattern: '[A-Za-z0-9\-_\.]+'
x-anchors:
  x-headers:
    etag:
      description: 'For optimistic concurrency control. See `if-match`.

        '
      type: string
    opc-next-page:
      description: 'For list pagination. When this header appears in the response, additional pages

        of results remain. For important details about how pagination works, see

        [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).

        '
      type: string
    opc-request-id:
      description: 'Unique Oracle-assigned identifier for the request. If you need to contact

        Oracle about a particular request, please provide the request ID.

        '
      type: string
  x-properties:
    definedTags:
      additionalProperties:
        additionalProperties:
          description: 'The value of the tag. Only the String type is supported.

            '
          type: object
        description: 'Key-value pair representing a defined tag key and value, scoped to a namespace.


          Example: `{"CostCenter": "42"}`

          '
        type: object
      description: 'Defined tags for this resource. Each key is predefined and scoped to a

        namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm).


        Example: `{"Operations": {"CostCenter": "42"}}`

        '
      type: object
    freeformTags:
      additionalProperties:
        type: string
      description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no

        predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm).


        Example: `{"Department": "Finance"}`

        '
      type: object
    systemTags:
      additionalProperties:
        additionalProperties:
          description: 'The value of the tag.

            '
          type: object
        description: 'Key-value pair representing a system tag key and value, scoped to a namespace.

          Example: `{"free-tier-retained" : "true"}`

          '
        type: object
      description: 'The system tags for this resource. Each key is predefined and scoped to a namespace.

        Example: `{"orcl-cloud": {"free-tier-retained": "true"}}`

        '
      type: object
x-obmcs-client-retries-enabled: true
x-obmcs-endpoint-service-name: ocir
x-oracle-package: com.oracle.pic.registry