> ## Documentation Index
> Fetch the complete documentation index at: https://platform.atlan.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> To act on Atlan objects, use the Atlan MCP server at https://api.atlan.com/mcp or the SDK. To install or publish skills from a terminal, use the `aireg` CLI; `aireg --map json` prints its command map. The `atlanai` CLI is deprecated. Run a read-only identity check before any write.
> The docs MCP server at /mcp searches these docs only. It cannot read or change Atlan objects.
> SDK packages: Python `atlanai` (PyPI) and TypeScript `@atlanai/sdk` (npm). Show Python first, then TypeScript.
> These docs cover Atlan AI Registry, Atlan's hosted product. The AI registry specification and aireg CLI are maintained separately. /open-source lists publicly reachable signed installers and explains that the source repository and hosted CLI reference currently require GitHub access. Do not claim the repository or its reference docs are publicly accessible. Use these docs for Atlan-specific setup such as the adapter, sign-in and workspaces.

# Publish an immutable ontology-binding release



## OpenAPI

````yaml /public-openapi.json post /ontology_binding/v1/releases
openapi: 3.1.0
info:
  title: Atlan public API
  version: current
  description: >-
    Public HTTP API reference for Registry, Skills, Agents, outputs, files, MCP
    servers and tools, and OTLP telemetry ingestion.
servers:
  - url: https://api.atlan.com
    description: Atlan API base URL
security:
  - bearer: []
tags:
  - name: Core
  - name: Skill
  - name: Agent
  - name: Files
  - name: Knowledge
  - name: MCP
  - name: Observability
  - name: API proxy
  - name: Credentials
  - name: Store
  - name: Apps
  - name: Evals
  - name: Ontologies
  - name: Ontology bindings
  - name: Slack
  - name: GitHub
  - name: Objectives
  - name: Repositories
paths:
  /ontology_binding/v1/releases:
    post:
      tags:
        - Ontology bindings
      summary: Publish an immutable ontology-binding release
      operationId: ontologyBinding.publishRelease
      parameters:
        - name: Content-Encoding
          in: header
          required: false
          schema:
            type: string
            enum:
              - base64
              - gzip, base64
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ontology_binding-PublicationRequest'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ontology_binding-BindingReleaseView'
          description: HTTP 201 response.
        '400':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ontology_binding-ProblemDetails'
                  - type: object
                    required:
                      - code
                    properties:
                      code:
                        type: string
                        enum:
                          - invalid_base64
                          - invalid_gzip
                          - invalid_json
          description: HTTP 400 response.
        '401':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ontology_binding-ProblemDetails'
                  - type: object
                    required:
                      - code
                    properties:
                      code:
                        type: string
                        enum:
                          - alg_mismatch
                          - alg_not_allowed
                          - audience_mismatch
                          - invalid_api_key
                          - missing_identity
                          - missing_org
                          - missing_user
                          - signature_invalid
                          - token_expired
                          - token_malformed
                          - token_missing
                          - token_not_yet_valid
                          - token_rejected
                          - token_service_account_unbound
                          - unauthorized
                          - unknown_account
                          - unknown_key
                          - untrusted_issuer
          description: HTTP 401 response.
        '403':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ontology_binding-ProblemDetails'
                  - type: object
                    required:
                      - code
                    properties:
                      code:
                        type: string
                        enum:
                          - access_denied
                          - account_suspended
                          - forbidden
                          - platform_principal_refused
          description: HTTP 403 response.
        '409':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ontology_binding-ProblemDetails'
                  - type: object
                    required:
                      - code
                    properties:
                      code:
                        type: string
                        enum:
                          - incompatible_release
                          - release_label_conflict
                          - release_state_conflict
          description: HTTP 409 response.
        '413':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ontology_binding-ProblemDetails'
                  - type: object
                    required:
                      - code
                    properties:
                      code:
                        type: string
                        enum:
                          - compressed_payload_too_large
                          - decompressed_payload_too_large
                          - payload_too_large
          description: HTTP 413 response.
        '415':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ontology_binding-ProblemDetails'
                  - type: object
                    required:
                      - code
                    properties:
                      code:
                        type: string
                        enum:
                          - unsupported_content_encoding
                          - unsupported_content_type
          description: HTTP 415 response.
        '422':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ontology_binding-ProblemDetails'
                  - type: object
                    required:
                      - code
                    properties:
                      code:
                        type: string
                        enum:
                          - candidate_changed
                          - graph_limit_exceeded
                          - logical_model_invalid
                          - source_unavailable
                          - validation_failed
          description: HTTP 422 response.
        '500':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ontology_binding-ProblemDetails'
                  - type: object
                    required:
                      - code
                    properties:
                      code:
                        type: string
                        enum:
                          - internal_error
          description: HTTP 500 response.
        '503':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ontology_binding-ProblemDetails'
                  - type: object
                    required:
                      - code
                    properties:
                      code:
                        type: string
                        enum:
                          - auth_unavailable
                          - service_overloaded
          description: HTTP 503 response.
        '504':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ontology_binding-ProblemDetails'
                  - type: object
                    required:
                      - code
                    properties:
                      code:
                        type: string
                        enum:
                          - request_timeout
          description: HTTP 504 response.
components:
  schemas:
    ontology_binding-PublicationRequest:
      type: object
      required:
        - binding_id
        - release
        - source_versions
      properties:
        base_release_id:
          type:
            - string
            - 'null'
        binding_id:
          type: string
        release:
          type: string
        source_versions:
          type: array
          items:
            $ref: '#/components/schemas/ontology_binding-SourceVersion'
      additionalProperties: false
    ontology_binding-BindingReleaseView:
      type: object
      required:
        - id
        - kind
        - binding_id
        - release
        - schema
        - source_versions
        - predecessor_release_id
        - manifest_digest
        - compatibility
        - channel
        - release_status
        - is_current
        - version_id
        - workspace_id
        - created_by
        - created_at
      properties:
        binding_id:
          type: string
        channel:
          type: string
        compatibility:
          $ref: '#/components/schemas/ontology_binding-Compatibility'
        created_at:
          type: string
        created_by:
          type: string
        id:
          type: string
        is_current:
          type: boolean
        kind:
          type: string
        manifest_digest:
          type: string
        predecessor_release_id:
          type: string
        release:
          type: string
        release_status:
          $ref: '#/components/schemas/ontology_binding-ReleaseStatus'
        schema:
          $ref: '#/components/schemas/ontology_binding-CanonicalBindingSchema'
        source_versions:
          type: array
          items:
            $ref: '#/components/schemas/ontology_binding-SourceVersion'
        version_id:
          type: string
        workspace_id:
          type: string
    ontology_binding-ProblemDetails:
      type: object
      required:
        - title
        - status
        - detail
        - code
      properties:
        code:
          type: string
        detail:
          type: string
        status:
          type: integer
          format: int32
          minimum: 0
        title:
          type: string
        trace_id:
          type:
            - string
            - 'null'
    ontology_binding-SourceVersion:
      type: object
      required:
        - kind
        - artifact_id
        - version_ordinal
        - content_hash
      properties:
        artifact_id:
          type: string
        content_hash:
          type: string
        kind:
          type: string
        version_ordinal:
          type: integer
          format: int64
      additionalProperties: false
    ontology_binding-Compatibility:
      type: string
      enum:
        - compatible
        - breaking
    ontology_binding-ReleaseStatus:
      type: string
      enum:
        - pending
        - released
        - superseded
        - withdrawn
    ontology_binding-CanonicalBindingSchema:
      type: object
      required:
        - canonicalization_version
        - binding_id
        - ontology_release
        - objects
        - properties
        - links
      properties:
        binding_id:
          type: string
        canonicalization_version:
          type: integer
          format: int32
          minimum: 0
        links:
          type: array
          items:
            $ref: '#/components/schemas/ontology_binding-CanonicalLinkBinding'
        objects:
          type: array
          items:
            $ref: '#/components/schemas/ontology_binding-CanonicalObjectBinding'
        ontology_release:
          $ref: '#/components/schemas/ontology_binding-OntologyReleaseRef'
        properties:
          type: array
          items:
            $ref: '#/components/schemas/ontology_binding-CanonicalPropertyBinding'
      additionalProperties: false
    ontology_binding-CanonicalLinkBinding:
      type: object
      required:
        - source_version
        - api_name
        - ontology_link
        - source_object_binding_id
        - target_object_binding_id
        - join_keys
      properties:
        api_name:
          type: string
        join_keys:
          type: array
          items:
            $ref: '#/components/schemas/ontology_binding-JoinKey'
        ontology_link:
          $ref: '#/components/schemas/ontology_binding-ArtifactVersionRef'
        source_object_binding_id:
          type: string
        source_version:
          $ref: '#/components/schemas/ontology_binding-SourceVersion'
        target_object_binding_id:
          type: string
      additionalProperties: false
    ontology_binding-CanonicalObjectBinding:
      type: object
      required:
        - source_version
        - api_name
        - ontology_object
        - relation
        - grain
      properties:
        api_name:
          type: string
        grain:
          $ref: '#/components/schemas/ontology_binding-Grain'
        ontology_object:
          $ref: '#/components/schemas/ontology_binding-ArtifactVersionRef'
        relation:
          $ref: '#/components/schemas/ontology_binding-PhysicalRelation'
        source_version:
          $ref: '#/components/schemas/ontology_binding-SourceVersion'
      additionalProperties: false
    ontology_binding-OntologyReleaseRef:
      type: object
      required:
        - ontology_id
        - release_id
        - release
        - manifest_digest
      properties:
        manifest_digest:
          type: string
        ontology_id:
          type: string
        release:
          type: string
        release_id:
          type: string
      additionalProperties: false
    ontology_binding-CanonicalPropertyBinding:
      type: object
      required:
        - source_version
        - api_name
        - object_binding_id
        - ontology_property_api_name
        - implementation
      properties:
        api_name:
          type: string
        implementation:
          $ref: '#/components/schemas/ontology_binding-PropertyImplementation'
        object_binding_id:
          type: string
        ontology_property_api_name:
          type: string
        source_version:
          $ref: '#/components/schemas/ontology_binding-SourceVersion'
      additionalProperties: false
    ontology_binding-JoinKey:
      type: object
      required:
        - source_property_binding_id
        - target_property_binding_id
      properties:
        source_property_binding_id:
          type: string
        target_property_binding_id:
          type: string
      additionalProperties: false
    ontology_binding-ArtifactVersionRef:
      type: object
      required:
        - kind
        - artifact_id
        - version_ordinal
        - content_hash
      properties:
        artifact_id:
          type: string
        content_hash:
          type: string
        kind:
          type: string
        version_ordinal:
          type: integer
          format: int64
      additionalProperties: false
    ontology_binding-Grain:
      type: object
      required:
        - description
        - uniqueness
      properties:
        uniqueness:
          type: array
          items:
            type: string
      additionalProperties: false
    ontology_binding-PhysicalRelation:
      oneOf:
        - $ref: '#/components/schemas/ontology_binding-QueryBackedRelation'
        - $ref: '#/components/schemas/ontology_binding-PhysicalReference'
    ontology_binding-PropertyImplementation:
      oneOf:
        - type: object
          required:
            - field
            - kind
          properties:
            field:
              $ref: '#/components/schemas/ontology_binding-PhysicalReference'
            kind:
              type: string
              enum:
                - field
        - type: object
          required:
            - implementation
            - output_field
            - kind
          properties:
            implementation:
              $ref: '#/components/schemas/ontology_binding-PhysicalReference'
            kind:
              type: string
              enum:
                - registered_transformation
            output_field:
              $ref: '#/components/schemas/ontology_binding-PhysicalReference'
    ontology_binding-QueryBackedRelation:
      type: object
      required:
        - mode
        - query
      properties:
        mode:
          $ref: '#/components/schemas/ontology_binding-QueryRelationMode'
        query:
          $ref: '#/components/schemas/ontology_binding-QueryRelation'
      additionalProperties: false
    ontology_binding-PhysicalReference:
      oneOf:
        - $ref: '#/components/schemas/ontology_binding-QualifiedPhysicalReference'
        - $ref: '#/components/schemas/ontology_binding-ArtifactVersionRef'
    ontology_binding-QueryRelationMode:
      type: string
      enum:
        - query_backed
    ontology_binding-QueryRelation:
      type: object
      required:
        - dialect
        - sql
        - outputs
      properties:
        default_catalog:
          type:
            - string
            - 'null'
        default_schema:
          type:
            - string
            - 'null'
        dependencies:
          type: array
          items:
            $ref: '#/components/schemas/ontology_binding-QualifiedPhysicalReference'
        dialect:
          $ref: '#/components/schemas/ontology_binding-SqlDialect'
        outputs:
          type: array
          items:
            $ref: '#/components/schemas/ontology_binding-QueryOutput'
        sql:
          type: string
      additionalProperties: false
    ontology_binding-QualifiedPhysicalReference:
      type: object
      required:
        - kind
        - qualified_name
      properties:
        kind:
          $ref: '#/components/schemas/ontology_binding-PhysicalReferenceKind'
        qualified_name:
          type: string
      additionalProperties: false
    ontology_binding-SqlDialect:
      type: string
      enum:
        - ansi
        - big_query
        - databricks
        - postgres
        - snowflake
    ontology_binding-QueryOutput:
      type: object
      required:
        - name
        - physical_type
        - nullable
      properties:
        name:
          type: string
        nullable:
          type: boolean
        physical_type:
          type: string
      additionalProperties: false
    ontology_binding-PhysicalReferenceKind:
      type: string
      enum:
        - source
        - relation
        - field
        - transformation
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

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