Microsoft Azure AcrMetadata API

The AcrMetadata API from Microsoft Azure — 5 operation(s) for acrmetadata.

Documentation GitHub OpenAPI

Operations 6

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /acr/v1/{name} Get a container registry repository's attributes · Microsoft Azure Get Acr Name #

Ask an LLM

“How do I see the attributes of a repository in Azure Container Registry?”

“Is a given ACR repository locked against deletes or writes?”

Tell an agent

Get the attributes of repository {name}.

Show whether repository {name} allows delete, write, list and read.

PATCH /acr/v1/{name} Lock or unlock a registry repository · Microsoft Azure Patch Acr Name #

Ask an LLM

“Can I stop anyone from deleting or overwriting images in an ACR repository?”

“How do I make a whole container repository read-only?”

Tell an agent

Set delete-enabled to {deleteEnabled} on repository {name}.

Lock repository {name} by setting write-enabled to {writeEnabled}.

GET /acr/v1/{name}/_tags List tags in a registry repository · Microsoft Azure Get Acr Name Tags #

Ask an LLM

“What image tags exist in my container repository?”

“Can I page through repository tags sorted by time or limited to one digest?”

Tell an agent

List the tags in repository {name}.

Show {n} tags from repository {name} ordered by {orderby}.

GET /acr/v1/{name}/_tags/{reference} Get the attributes of one image tag · Microsoft Azure Get Acr Name Tags Reference #

Ask an LLM

“How do I read the metadata of a single tag in an ACR repository?”

“Which digest does a specific image tag point to, and is it locked?”

Tell an agent

Get the attributes of tag {reference} in repository {name}.

Show the digest behind {name}:{reference}.

PATCH /acr/v1/{name}/_tags/{reference} Update the attributes of an image tag · Microsoft Azure Patch Acr Name Tags Reference #

Ask an LLM

“Can I lock a single image tag so it can't be overwritten or deleted?”

“How do I change the write or delete permissions on one ACR tag?”

Tell an agent

Update the attributes of tag {reference} in repository {name} to {value}.

Lock tag {name}:{reference} against changes.

DELETE /acr/v1/{name}/_tags/{reference} Delete an image tag · Microsoft Azure Delete Acr Name Tags Reference #

Ask an LLM

“How do I delete one tag from a container repository?”

“Can I untag an image in Azure Container Registry without deleting the whole repository?”

Tell an agent destructive · confirm first

Delete tag {reference} from repository {name}.

Untag {name}:{reference}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/microsoft-azure:microsoft-azure-acrmetadata-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Microsoft Azure Azure Container Registry Acr Metadata API
  description: Metadata API definition for the Azure Container Registry runtime
  version: 2019-07-15-preview
security:
- registry_auth: []
  registry_oauth2: []
tags:
- name: AcrMetadata
paths:
  /acr/v1/{name}:
    get:
      tags:
      - AcrMetadata
      description: Get repository attributes
      operationId: microsoftAzureGetacrrepositoryattributes
      x-ms-examples:
        Get details of repository:
          $ref: ./examples/GetAcrRepositoryAttributes.json
      parameters:
      - $ref: '#/components/parameters/ImageName'
      responses:
        '200':
          description: Returns a list of attributes
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepositoryAttributes'
        default:
          description: ACR error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AcrErrors'
      summary: Microsoft Azure Get Acr Name
    patch:
      tags:
      - AcrMetadata
      description: Update the attribute identified by `name` where `reference` is the name of the repository.
      operationId: microsoftAzureUpdateacrrepositoryattributes
      x-ms-examples:
        Update repository attributes:
          $ref: ./examples/UpdateAcrRepository.json
      parameters:
      - $ref: '#/components/parameters/ImageName'
      responses:
        '200':
          description: The attributes is updated
        default:
          description: ACR error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AcrErrors'
      summary: Microsoft Azure Patch Acr Name
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChangeableAttributes'
        description: Repository attribute value
  /acr/v1/{name}/_tags:
    get:
      tags:
      - AcrMetadata
      description: List tags of a repository
      operationId: microsoftAzureGetacrtags
      x-ms-examples:
        Get tags of a repository:
          $ref: ./examples/GetAcrTags.json
      parameters:
      - $ref: '#/components/parameters/ImageName'
      - $ref: '#/components/parameters/QueryLast'
      - $ref: '#/components/parameters/QueryNum'
      - $ref: '#/components/parameters/QueryOrderBy'
      - $ref: '#/components/parameters/QueryDigest'
      responses:
        '200':
          description: Tag details of a repository
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AcrRepositoryTags'
        default:
          description: ACR error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AcrErrors'
      summary: Microsoft Azure Get Acr Name Tags
  /acr/v1/{name}/_tags/{reference}:
    get:
      tags:
      - AcrMetadata
      description: Get tag attributes by tag
      operationId: microsoftAzureGetacrtagattributes
      x-ms-examples:
        Get tag attributes:
          $ref: ./examples/GetAcrTagAttributes.json
      parameters:
      - $ref: '#/components/parameters/ImageName'
      - $ref: '#/components/parameters/ManifestReference'
      responses:
        '200':
          description: Tag attributes
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AcrTagAttributes'
        default:
          description: ACR error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AcrErrors'
      summary: Microsoft Azure Get Acr Name Tags Reference
    patch:
      tags:
      - AcrMetadata
      description: Update tag attributes
      operationId: microsoftAzureUpdateacrtagattributes
      x-ms-examples:
        Update attributes of a manifest:
          $ref: ./examples/UpdateAcrTagAttributes.json
      parameters:
      - $ref: '#/components/parameters/ImageName'
      - $ref: '#/components/parameters/ManifestReference'
      - $ref: '#/components/parameters/RepoValue'
      responses:
        '200':
          description: The attributes are updated
        default:
          description: ACR error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AcrErrors'
      summary: Microsoft Azure Patch Acr Name Tags Reference
    delete:
      tags:
      - AcrMetadata
      description: Delete tag
      operationId: microsoftAzureDeleteacrtag
      x-ms-examples:
        Update attributes of a manifest:
          $ref: ./examples/DeleteAcrTag.json
      parameters:
      - $ref: '#/components/parameters/ImageName'
      - $ref: '#/components/parameters/ManifestReference'
      responses:
        '202':
          description: The tag is deleted
        default:
          description: ACR error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AcrErrors'
      summary: Microsoft Azure Delete Acr Name Tags Reference
components:
  parameters:
    ManifestReference:
      name: reference
      in: path
      description: Tag or digest of the target manifest
      required: true
      x-ms-parameter-location: method
      schema:
        type: string
    QueryDigest:
      name: digest
      in: query
      description: filter by digest
      required: false
      x-ms-parameter-location: method
      schema:
        type: string
    RepoValue:
      name: value
      in: body
      description: Repository attribute value
      required: false
      schema:
        $ref: '#/components/schemas/ChangeableAttributes'
      x-ms-parameter-location: method
    QueryNum:
      name: n
      in: query
      description: query parameter for max number of items
      required: false
      x-ms-parameter-location: method
      schema:
        type: integer
    QueryOrderBy:
      name: orderby
      in: query
      description: orderby query parameter
      required: false
      x-ms-parameter-location: method
      schema:
        type: string
    QueryLast:
      name: last
      in: query
      description: Query parameter for the last item in previous query. Result set will include values lexically after last.
      required: false
      x-ms-parameter-location: method
      schema:
        type: string
    ImageName:
      name: name
      in: path
      description: Name of the image (including the namespace)
      required: true
      x-ms-parameter-location: method
      schema:
        type: string
  schemas:
    AcrTagAttributes:
      description: Tag attributes
      properties:
        registry:
          type: string
          description: Registry name
        imageName:
          type: string
          description: Image name
        tag:
          x-ms-client-name: TagAttributes
          description: List of tag attribute details
          $ref: '#/components/schemas/AcrTagAttributesBase'
      example:
        registry: registry
        imageName: imageName
        tag:
          changeableAttributes:
            readEnabled: true
            listEnabled: true
            deleteEnabled: true
            writeEnabled: true
          name: name
          digest: digest
          createdTime: createdTime
          signed: true
          lastUpdateTime: lastUpdateTime
    AcrErrorInfo:
      description: Error information
      properties:
        code:
          description: Error code
          type: string
        message:
          type: string
          description: Error message
        detail:
          type: object
          description: Error details
    AcrTagAttributesBase:
      description: Tag attribute details
      properties:
        name:
          type: string
          description: Tag name
        digest:
          type: string
          description: Tag digest
        createdTime:
          type: string
          description: Tag created time
        lastUpdateTime:
          type: string
          description: Tag last update time
        signed:
          type: boolean
          description: Is signed
        changeableAttributes:
          $ref: '#/components/schemas/ChangeableAttributes'
          description: Changeable attributes
      example:
        changeableAttributes:
          readEnabled: true
          listEnabled: true
          deleteEnabled: true
          writeEnabled: true
        name: tagname
        digest: sha256:0873c923e00e0fd2ba78041bfb64a105e1ecb7678916d1f7776311e45bf5634b
        createdTime: '2018-08-10T17:28:44.1082945Z'
        signed: true
        lastUpdateTime: '2018-08-10T17:28:44.1082945Z'
    RepositoryAttributes:
      type: object
      description: Repository attributes
      properties:
        registry:
          type: string
          description: Registry name
        imageName:
          type: string
          description: Image name
        createdTime:
          type: string
          description: Image created time
        lastUpdateTime:
          type: string
          description: Image last update time
        manifestCount:
          type: integer
          description: Number of the manifests
        tagCount:
          type: integer
          description: Number of the tags
        changeableAttributes:
          description: Changeable attributes
          $ref: '#/components/schemas/ChangeableAttributes'
      example:
        registry: registryname.azurecr.io
        changeableAttributes:
          readEnabled: true
          listEnabled: true
          deleteEnabled: true
          writeEnabled: true
        imageName: imageName
        createdTime: '2018-09-07T16:30:46.6583219Z'
        tagCount: 6
        manifestCount: 2
        lastUpdateTime: '2018-09-07T16:30:46.6583219Z'
    AcrErrors:
      description: Acr error response describing why the operation failed
      properties:
        errors:
          type: array
          description: Array of detailed error
          items:
            $ref: '#/components/schemas/AcrErrorInfo'
    AcrRepositoryTags:
      description: List of tag details
      properties:
        registry:
          type: string
          description: Registry name
        imageName:
          type: string
          description: Image name
        tags:
          type: array
          x-ms-client-name: TagsAttributes
          description: List of tag attribute details
          items:
            $ref: '#/components/schemas/AcrTagAttributesBase'
      example:
        registry: registry
        imageName: imageName
        tags:
        - changeableAttributes:
            readEnabled: true
            listEnabled: true
            deleteEnabled: true
            writeEnabled: true
          name: name
          digest: digest
          createdTime: createdTime
          signed: true
          lastUpdateTime: lastUpdateTime
        - changeableAttributes:
            readEnabled: true
            listEnabled: true
            deleteEnabled: true
            writeEnabled: true
          name: name
          digest: digest
          createdTime: createdTime
          signed: true
          lastUpdateTime: lastUpdateTime
    ChangeableAttributes:
      properties:
        deleteEnabled:
          type: boolean
          description: Delete enabled
        writeEnabled:
          type: boolean
          description: Write enabled
        listEnabled:
          type: boolean
          description: List enabled
        readEnabled:
          type: boolean
          description: Read enabled
      example:
        readEnabled: true
        listEnabled: true
        deleteEnabled: true
        writeEnabled: true
  securitySchemes:
    registry_auth:
      type: http
      scheme: basic
    registry_oauth2:
      type: apiKey
      in: header
      name: Authorization
x-ms-parameterized-host:
  hostTemplate: '{url}'
  useSchemePrefix: false
  positionInOperation: first
  parameters:
  - $ref: '#/components/parameters/Url'

Microsoft Azure AcrMetadata API

Operations 6

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification