> ## 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.

# Compile bounded release-consistent ontology context



## OpenAPI

````yaml /public-openapi.json post /ontology/v1/context-queries
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/v1/context-queries:
    post:
      tags:
        - Ontologies
      summary: Compile bounded release-consistent ontology context
      operationId: ontology.getContext
      parameters:
        - name: Content-Encoding
          in: header
          required: false
          schema:
            type: string
            enum:
              - base64
              - gzip, base64
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ontology-ContextQuery'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ontology-ContextResponse'
          description: HTTP 200 response.
        '400':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ontology-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-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-ProblemDetails'
                  - type: object
                    required:
                      - code
                    properties:
                      code:
                        type: string
                        enum:
                          - access_denied
                          - account_suspended
                          - forbidden
                          - platform_principal_refused
          description: HTTP 403 response.
        '404':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ontology-ProblemDetails'
                  - type: object
                    required:
                      - code
                    properties:
                      code:
                        type: string
                        enum:
                          - not_found
          description: HTTP 404 response.
        '413':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ontology-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-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-ProblemDetails'
                  - type: object
                    required:
                      - code
                    properties:
                      code:
                        type: string
                        enum:
                          - unprocessable
                          - validation_failed
          description: HTTP 422 response.
        '500':
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ontology-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-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-ProblemDetails'
                  - type: object
                    required:
                      - code
                    properties:
                      code:
                        type: string
                        enum:
                          - request_timeout
          description: HTTP 504 response.
components:
  schemas:
    ontology-ContextQuery:
      type: object
      required:
        - ontology_id
        - release_id
        - query
      properties:
        diagnostics:
          type: boolean
        include:
          type: array
          items:
            $ref: '#/components/schemas/ontology-ContextCategory'
        max_depth:
          type:
            - integer
            - 'null'
          minimum: 0
        max_resources:
          type:
            - integer
            - 'null'
          minimum: 0
        max_tokens:
          type:
            - integer
            - 'null'
          minimum: 0
        ontology_id:
          type: string
        query:
          type: string
        release_id:
          type: string
      additionalProperties: false
    ontology-ContextResponse:
      type: object
      required:
        - release_id
        - release
        - manifest_digest
        - resources
        - max_resources
        - max_depth
        - max_tokens
        - token_estimate
        - truncated
        - refinement_hints
      properties:
        diagnostics:
          oneOf:
            - $ref: '#/components/schemas/ontology-ContextDiagnostics'
            - type: 'null'
        manifest_digest:
          type: string
        max_depth:
          type: integer
          minimum: 0
        max_resources:
          type: integer
          minimum: 0
        max_tokens:
          type: integer
          minimum: 0
        refinement_hints:
          type: array
          items:
            type: string
        release:
          type: string
        release_id:
          type: string
        resources:
          type: array
          items:
            $ref: '#/components/schemas/ontology-ContextResource'
        token_estimate:
          type: integer
          minimum: 0
        truncated:
          type: boolean
    ontology-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-ContextCategory:
      type: string
      enum:
        - object_types
        - interface_types
        - link_types
        - shared_property_types
        - action_types
        - concept_schemes
        - concepts
    ontology-ContextDiagnostics:
      type: object
      required:
        - registry_candidates
        - release_candidates
        - lexical_candidates
        - expanded_candidates
        - returned_resources
      properties:
        expanded_candidates:
          type: integer
          minimum: 0
        lexical_candidates:
          type: integer
          minimum: 0
        registry_candidates:
          type: integer
          minimum: 0
        release_candidates:
          type: integer
          minimum: 0
        returned_resources:
          type: integer
          minimum: 0
    ontology-ContextResource:
      type: object
      required:
        - kind
        - artifact_id
        - api_name
        - definition
        - score
        - selected_because
        - depth
      properties:
        api_name:
          type: string
        artifact_id:
          type: string
        definition: {}
        depth:
          type: integer
          minimum: 0
        kind:
          type: string
        score:
          type: integer
          format: int32
          minimum: 0
        selected_because:
          type: array
          items:
            $ref: '#/components/schemas/ontology-SelectionReason'
    ontology-SelectionReason:
      type: string
      enum:
        - term_match
        - registry_rank
        - relationship_path
        - interface_implementation
        - required_dependency
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

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