> ## 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. # Plan or evaluate a bounded SPARQL SELECT query over an ontology release ## OpenAPI ````yaml /public-openapi.json post /ontology/v1/query-plans 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/query-plans: post: tags: - Ontologies summary: Plan or evaluate a bounded SPARQL SELECT query over an ontology release operationId: ontology.planSparqlQuery parameters: - name: Content-Encoding in: header required: false schema: type: string enum: - base64 - gzip, base64 requestBody: content: application/json: schema: $ref: '#/components/schemas/ontology-SparqlPlanRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/ontology-SparqlPlanResponse' 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-SparqlPlanRequest: type: object required: - ontology_id - release_id - query properties: include_definitions: type: boolean max_operations: type: integer default: 128 maximum: 256 minimum: 1 ontology_id: type: string query: type: string maxLength: 65536 minLength: 1 release_id: type: string additionalProperties: false ontology-SparqlPlanResponse: type: object required: - release_id - manifest_digest - query_mode - is_executable - requires_bindings - logical_plan - resolved_resources - result_bindings - unresolved_terms - diagnostics properties: diagnostics: type: array items: $ref: '#/components/schemas/ontology-SparqlDiagnostic' is_executable: type: boolean logical_plan: type: array items: $ref: '#/components/schemas/ontology-LogicalPlanOperation' manifest_digest: type: string query_mode: $ref: '#/components/schemas/ontology-SparqlQueryMode' release_id: type: string requires_bindings: type: boolean resolved_resources: type: array items: $ref: '#/components/schemas/ontology-ResolvedResource' result_bindings: type: array items: type: object additionalProperties: type: string propertyNames: type: string unresolved_terms: type: array items: type: string 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-SparqlDiagnostic: type: object required: - code - message properties: code: type: string message: type: string ontology-LogicalPlanOperation: type: object required: - operator properties: expression: type: - string - 'null' limit: type: - integer - 'null' minimum: 0 object: type: - string - 'null' offset: type: - integer - 'null' minimum: 0 operator: type: string predicate: type: - string - 'null' subject: type: - string - 'null' ontology-SparqlQueryMode: type: string enum: - ontology_metadata - instance_data ontology-ResolvedResource: type: object required: - kind - artifact_id - api_name properties: api_name: type: string artifact_id: type: string definition: {} kind: type: string matched_property_api_name: type: - string - 'null' securitySchemes: bearer: type: http scheme: bearer bearerFormat: JWT ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.