Azure Container Apps Certificates API

The Certificates API from Azure Container Apps — 4 operation(s) for certificates.

GitHub OpenAPI

Operations 10

GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/connectedEnvironments/{connectedEnvironmentName}/certificates Get the Certificates in a given connected environment #
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/connectedEnvironments/{connectedEnvironmentName}/certificates/{certificateName} Get the specified Certificate #
PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/connectedEnvironments/{connectedEnvironmentName}/certificates/{certificateName} Create or Update a Certificate #
PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/connectedEnvironments/{connectedEnvironmentName}/certificates/{certificateName} Update properties of a certificate #
DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/connectedEnvironments/{connectedEnvironmentName}/certificates/{certificateName} Deletes the specified Certificate #
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/managedEnvironments/{environmentName}/certificates Get the Certificates in a given managed environment #
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/managedEnvironments/{environmentName}/certificates/{certificateName} Get the specified Certificate #
PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/managedEnvironments/{environmentName}/certificates/{certificateName} Create or Update a Certificate #
PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/managedEnvironments/{environmentName}/certificates/{certificateName} Update properties of a certificate #
DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/managedEnvironments/{environmentName}/certificates/{certificateName} Deletes the specified Certificate #

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/azure-container-apps:azure-container-apps-certificates-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

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

OpenAPI Specification

azure-container-apps-certificates-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: ContainerApps API Client Certificates API
  version: '2026-07-01'
  description: Functions is an extension resource to revisions and the api listed is used to proxy the call from Web RP to the function app's host process, this api is not exposed to users and only Web RP is allowed to invoke functions extension resource.
  x-typespec-generated:
  - emitter: '@azure-tools/typespec-autorest'
servers:
- url: https://management.azure.com
security:
- azure_auth:
  - user_impersonation
tags:
- name: Certificates
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/connectedEnvironments/{connectedEnvironmentName}/certificates
  : get:
      operationId: ConnectedEnvironmentsCertificates_List
      tags:
      - Certificates
      summary: Get the Certificates in a given connected environment
      description: Get the Certificates in a given connected environment.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - name: connectedEnvironmentName
        in: path
        description: Name of the Connected Environment.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CertificateCollection'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-pageable:
        nextLinkName: nextLink
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/connectedEnvironments/{connectedEnvironmentName}/certificates/{certificateName}
  : get:
      operationId: ConnectedEnvironmentsCertificates_Get
      tags:
      - Certificates
      summary: Get the specified Certificate
      description: Get the specified Certificate.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - name: connectedEnvironmentName
        in: path
        description: Name of the Connected Environment.
        required: true
        schema:
          type: string
      - name: certificateName
        in: path
        description: Name of the Certificate.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Certificate'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    put:
      operationId: ConnectedEnvironmentsCertificates_CreateOrUpdate
      tags:
      - Certificates
      summary: Create or Update a Certificate
      description: Create or Update a Certificate.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - name: connectedEnvironmentName
        in: path
        description: Name of the Connected Environment.
        required: true
        schema:
          type: string
      - name: certificateName
        in: path
        description: Name of the Certificate.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Resource 'Certificate' update operation succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Certificate'
        '201':
          description: Resource 'Certificate' create operation succeeded
          headers:
            Azure-AsyncOperation:
              description: A link to the status monitor
              schema:
                type: string
            Retry-After:
              description: The Retry-After header can indicate how long the client should wait before polling the operation status.
              schema:
                type: integer
                format: int32
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Certificate'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-long-running-operation-options:
        final-state-via: azure-async-operation
        final-state-schema: '#/definitions/Certificate'
      x-ms-long-running-operation: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Certificate'
        description: Certificate to be created or updated
    patch:
      operationId: ConnectedEnvironmentsCertificates_Update
      tags:
      - Certificates
      summary: Update properties of a certificate
      description: Patches a certificate. Currently only patching of tags is supported
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - name: connectedEnvironmentName
        in: path
        description: Name of the Connected Environment.
        required: true
        schema:
          type: string
      - name: certificateName
        in: path
        description: Name of the Certificate.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Certificate'
        '202':
          description: Resource update request accepted.
          headers:
            Location:
              description: The Location header contains the URL where the status of the long running operation can be checked.
              schema:
                type: string
            Retry-After:
              description: The Retry-After header can indicate how long the client should wait before polling the operation status.
              schema:
                type: integer
                format: int32
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-long-running-operation-options:
        final-state-via: location
        final-state-schema: '#/definitions/Certificate'
      x-ms-long-running-operation: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CertificatePatch'
        description: Properties of a certificate that need to be updated
        required: true
    delete:
      operationId: ConnectedEnvironmentsCertificates_Delete
      tags:
      - Certificates
      summary: Deletes the specified Certificate
      description: Deletes the specified Certificate.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - name: connectedEnvironmentName
        in: path
        description: Name of the Connected Environment.
        required: true
        schema:
          type: string
      - name: certificateName
        in: path
        description: Name of the Certificate.
        required: true
        schema:
          type: string
      responses:
        '202':
          description: Resource deletion accepted.
          headers:
            Location:
              description: The Location header contains the URL where the status of the long running operation can be checked.
              schema:
                type: string
            Retry-After:
              description: The Retry-After header can indicate how long the client should wait before polling the operation status.
              schema:
                type: integer
                format: int32
        '204':
          description: Resource does not exist.
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-long-running-operation-options:
        final-state-via: location
      x-ms-long-running-operation: true
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/managedEnvironments/{environmentName}/certificates
  : get:
      operationId: Certificates_List
      tags:
      - Certificates
      summary: Get the Certificates in a given managed environment
      description: Get the Certificates in a given managed environment.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - name: environmentName
        in: path
        description: Name of the Managed Environment.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CertificateCollection'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-pageable:
        nextLinkName: nextLink
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/managedEnvironments/{environmentName}/certificates/{certificateName}
  : get:
      operationId: Certificates_Get
      tags:
      - Certificates
      summary: Get the specified Certificate
      description: Get the specified Certificate.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - name: environmentName
        in: path
        description: Name of the Managed Environment.
        required: true
        schema:
          type: string
      - name: certificateName
        in: path
        description: Name of the Certificate.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Certificate'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    put:
      operationId: Certificates_CreateOrUpdate
      tags:
      - Certificates
      summary: Create or Update a Certificate
      description: Create or Update a Certificate.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - name: environmentName
        in: path
        description: Name of the Managed Environment.
        required: true
        schema:
          type: string
      - name: certificateName
        in: path
        description: Name of the Certificate.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Resource 'Certificate' update operation succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Certificate'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Certificate'
        description: Certificate to be created or updated
    patch:
      operationId: Certificates_Update
      tags:
      - Certificates
      summary: Update properties of a certificate
      description: Patches a certificate. Currently only patching of tags is supported
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - name: environmentName
        in: path
        description: Name of the Managed Environment.
        required: true
        schema:
          type: string
      - name: certificateName
        in: path
        description: Name of the Certificate.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Certificate'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CertificatePatch'
        description: Properties of a certificate that need to be updated
        required: true
    delete:
      operationId: Certificates_Delete
      tags:
      - Certificates
      summary: Deletes the specified Certificate
      description: Deletes the specified Certificate.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - name: environmentName
        in: path
        description: Name of the Managed Environment.
        required: true
        schema:
          type: string
      - name: certificateName
        in: path
        description: Name of the Certificate.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Resource deleted successfully.
        '204':
          description: Resource does not exist.
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    Resource:
      type: object
      title: Resource
      description: Common fields that are returned in the response for all Azure Resource Manager resources
      properties:
        id:
          type: string
          format: arm-id
          description: Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
          readOnly: true
        name:
          type: string
          description: The name of the resource
          readOnly: true
        type:
          type: string
          description: The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
          readOnly: true
        systemData:
          $ref: '#/components/schemas/systemData'
          description: Azure Resource Manager metadata containing createdBy and modifiedBy information.
          readOnly: true
      x-ms-azure-resource: true
    CertificateProperties:
      type: object
      description: Certificate resource specific properties
      properties:
        provisioningState:
          $ref: '#/components/schemas/CertificateProvisioningState'
          description: Provisioning state of the certificate.
          readOnly: true
        deploymentErrors:
          type: string
          description: Any errors that occurred during deployment or deployment validation
          readOnly: true
        certificateKeyVaultProperties:
          $ref: '#/components/schemas/CertificateKeyVaultProperties'
          description: Properties for a certificate stored in a Key Vault.
        password:
          type: string
          format: password
          description: Certificate password.
          x-ms-mutability:
          - create
          x-ms-secret: true
        subjectName:
          type: string
          description: Subject name of the certificate.
          readOnly: true
        subjectAlternativeNames:
          type: array
          description: Subject alternative names the certificate applies to.
          items:
            type: string
          readOnly: true
        value:
          type: string
          format: password
          description: PFX or PEM blob
          x-ms-mutability:
          - create
          x-ms-secret: true
        issuer:
          type: string
          description: Certificate issuer.
          readOnly: true
        issueDate:
          type: string
          format: date-time
          description: Certificate issue Date.
          readOnly: true
        expirationDate:
          type: string
          format: date-time
          description: Certificate expiration date.
          readOnly: true
        thumbprint:
          type: string
          description: Certificate thumbprint.
          readOnly: true
        valid:
          type: boolean
          description: Is the certificate valid?.
          readOnly: true
        publicKeyHash:
          type: string
          description: Public key hash.
          readOnly: true
    CertificatePatch:
      type: object
      description: A certificate to update
      properties:
        tags:
          type: object
          description: Application-specific metadata in the form of key-value pairs.
          additionalProperties:
            type: string
    Certificate:
      type: object
      description: Certificate used for Custom Domain bindings of Container Apps in a Managed Environment
      properties:
        properties:
          $ref: '#/components/schemas/CertificateProperties'
          description: Certificate resource specific properties
      allOf:
      - $ref: '#/components/schemas/TrackedResource'
    ErrorResponse:
      type: object
      title: Error response
      description: Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
          description: The error object.
    CertificateKeyVaultProperties:
      type: object
      description: Properties for a certificate stored in a Key Vault.
      properties:
        identity:
          type: string
          description: Resource ID of a managed identity to authenticate with Azure Key Vault, or System to use a system-assigned identity.
        keyVaultUrl:
          type: string
          format: uri
          description: URL pointing to the Azure Key Vault secret that holds the certificate.
    CertificateProvisioningState:
      type: string
      description: Provisioning state of the certificate.
      enum:
      - Succeeded
      - Failed
      - Canceled
      - DeleteFailed
      - Pending
      - Deleting
      x-ms-enum:
        name: CertificateProvisioningState
        modelAsString: true
        values:
        - name: Succeeded
          value: Succeeded
          description: Succeeded
        - name: Failed
          value: Failed
          description: Failed
        - name: Canceled
          value: Canceled
          description: Canceled
        - name: DeleteFailed
          value: DeleteFailed
          description: DeleteFailed
        - name: Pending
          value: Pending
          description: Pending
        - name: Deleting
          value: Deleting
          description: Deleting
    CertificateCollection:
      type: object
      description: Collection of Certificates.
      properties:
        value:
          type: array
          description: The Certificate items on this page
          items:
            $ref: '#/components/schemas/Certificate'
        nextLink:
          type: string
          format: uri
          description: The link to the next page of items
      required:
      - value
    TrackedResource:
      type: object
      title: Tracked Resource
      description: The resource model definition for an Azure Resource Manager tracked top level resource which has 'tags' and a 'location'
      properties:
        tags:
          type: object
          description: Resource tags.
          additionalProperties:
            type: string
          x-ms-mutability:
          - read
          - create
          - update
        location:
          type: string
          description: The geo-location where the resource lives
          x-ms-mutability:
          - read
          - create
      required:
      - location
      allOf:
      - $ref: '#/components/schemas/Resource'
  parameters:
    ResourceGroupNameParameter:
      name: resourceGroupName
      in: path
      description: The name of the resource group. The name is case insensitive.
      required: true
      x-ms-parameter-location: method
      schema:
        type: string
        maxLength: 90
        minLength: 1
    SubscriptionIdParameter:
      name: subscriptionId
      in: path
      description: The ID of the target subscription. The value must be an UUID.
      required: true
      schema:
        type: string
        format: uuid
    ApiVersionParameter:
      name: api-version
      in: query
      description: The API version to use for this operation.
      required: true
      schema:
        type: string
        minLength: 1
  securitySchemes:
    azure_auth:
      type: oauth2
      flows:
        implicit:
          scopes:
            user_impersonation: impersonate your user account
          authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
      description: Azure Active Directory OAuth2 Flow.