> ## 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. # Release a first-party app definition ## OpenAPI ````yaml /public-openapi.json post /application/v1/definitions/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: /application/v1/definitions/releases: post: tags: - Apps summary: Release a first-party app definition operationId: application.releasePlatformApp parameters: - name: Content-Encoding in: header required: false schema: type: string enum: - base64 - gzip, base64 requestBody: content: application/json: schema: $ref: '#/components/schemas/application-application-ReleasePlatformApp' required: true responses: '201': content: application/json: schema: $ref: >- #/components/schemas/application-application-AppDefinitionRelease description: HTTP 201 response. '400': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/application-ProblemDetails' - type: object required: - code properties: code: type: string enum: - invalid_base64 - invalid_gzip - invalid_id - invalid_json - invalid_query - invalid_request description: HTTP 400 response. '401': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/application-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/application-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/application-ProblemDetails' - type: object required: - code properties: code: type: string enum: - not_found description: HTTP 404 response. '409': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/application-ProblemDetails' - type: object required: - code properties: code: type: string enum: - conflict description: HTTP 409 response. '412': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/application-ProblemDetails' - type: object required: - code properties: code: type: string enum: - precondition_failed description: HTTP 412 response. '413': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/application-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/application-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/application-ProblemDetails' - type: object required: - code properties: code: type: string enum: - invalid_field - missing_field - unprocessable - validation_failed description: HTTP 422 response. '429': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/application-ProblemDetails' - type: object required: - code properties: code: type: string enum: - budget_exceeded - rate_limited description: HTTP 429 response. '500': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/application-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/application-ProblemDetails' - type: object required: - code properties: code: type: string enum: - auth_unavailable - service_overloaded - service_unavailable description: HTTP 503 response. '504': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/application-ProblemDetails' - type: object required: - code properties: code: type: string enum: - request_timeout description: HTTP 504 response. components: schemas: application-application-ReleasePlatformApp: type: object required: - app_name - workspace_id - channel - version_label - visibility properties: app_name: $ref: '#/components/schemas/application-application-PlatformApp' channel: type: string version_label: type: string visibility: $ref: '#/components/schemas/application-ReleaseVisibility' workspace_id: type: string additionalProperties: false application-application-AppDefinitionRelease: type: object required: - definition_id - manifest - release properties: definition_id: type: string manifest: $ref: '#/components/schemas/application-application-AppManifest' release: $ref: '#/components/schemas/application-Release' application-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' application-application-PlatformApp: type: string enum: - ontology - metric - mcp - slack - github application-ReleaseVisibility: type: string enum: - private - public application-application-AppManifest: type: object required: - schema_version - app_name - display_name - runtime - ui_path properties: app_name: $ref: '#/components/schemas/application-application-PlatformApp' display_name: type: string runtime: $ref: '#/components/schemas/application-application-AppRuntime' schema_version: type: integer format: int32 minimum: 0 ui_path: type: string additionalProperties: false application-Release: type: object required: - release_id - artifact_id - kind - workspace_id - version_id - channel - visibility - release_status - is_current - created_by - created_at properties: artifact_id: type: string channel: type: string content_hash: type: - string - 'null' created_at: type: string created_by: type: string is_current: type: boolean kind: type: string notes: type: - string - 'null' reason: type: - string - 'null' release_id: type: string release_status: $ref: '#/components/schemas/application-ReleaseStatus' version_id: type: string version_label: type: - string - 'null' version_ordinal: type: - integer - 'null' format: int64 visibility: $ref: '#/components/schemas/application-ReleaseVisibility' workspace_id: type: string application-application-AppRuntime: type: string enum: - platform_extension application-ReleaseStatus: type: string enum: - pending - released - superseded - withdrawn securitySchemes: bearer: type: http scheme: bearer bearerFormat: JWT ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.