> ## 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. # List canonical insights ## OpenAPI ````yaml /public-openapi.json get /eval/v1/insights 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, Model Gateway, 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 - name: Models paths: /eval/v1/insights: get: tags: - Evals summary: List canonical insights operationId: eval.listInsights parameters: - in: query name: workspace_id required: true schema: type: string - in: query name: scorer_id required: false schema: type: string - in: query name: trace_id required: false schema: type: string - in: query name: choice required: false schema: type: string - in: query name: passed required: false schema: type: boolean - in: query name: score_min required: false schema: type: number format: double - in: query name: score_max required: false schema: type: number format: double - in: query name: is_score_missing required: false schema: type: boolean - in: query name: agent_id required: false schema: type: string - in: query name: agent_version required: false schema: type: integer format: int64 - in: query name: is_agent_version_missing required: false schema: type: boolean - in: query name: scorer_version required: false schema: type: integer format: int64 - in: query name: start_date required: false schema: format: date type: string - in: query name: end_date required: false schema: format: date type: string - name: limit in: query required: false schema: type: integer format: int32 minimum: 0 - name: offset in: query required: false schema: type: integer format: int32 minimum: 0 responses: '200': content: application/json: schema: $ref: '#/components/schemas/eval-eval-InsightPage' description: HTTP 200 response. '400': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/eval-ProblemDetails' - type: object required: - code properties: code: type: string enum: - invalid_query description: HTTP 400 response. '401': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/eval-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/eval-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/eval-ProblemDetails' - type: object required: - code properties: code: type: string enum: - not_found description: HTTP 404 response. '429': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/eval-ProblemDetails' - properties: code: enum: - rate_limited type: string required: - code type: object description: HTTP 429 response. '500': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/eval-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/eval-ProblemDetails' - properties: code: enum: - auth_unavailable - service_overloaded - service_unavailable - workspace_authorization_unavailable type: string required: - code type: object description: HTTP 503 response. '504': content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/eval-ProblemDetails' - type: object required: - code properties: code: type: string enum: - request_timeout description: HTTP 504 response. security: - bearer: [] components: schemas: eval-eval-InsightPage: properties: items: items: $ref: '#/components/schemas/eval-eval-Insight' type: array page: $ref: '#/components/schemas/eval-gateway-PageMeta' required: - items - page type: object eval-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' eval-eval-Insight: properties: agent_id: type: string agent_version: type: - integer - 'null' format: int64 answer_id: type: string choice: type: - string - 'null' confidence: type: - number - 'null' format: double execution_id: type: string observed_at: format: date-time type: string passed: type: - boolean - 'null' reasoning: type: - string - 'null' score: type: - number - 'null' format: double scorer_id: type: string scorer_version: type: integer format: int64 session_id: type: - string - 'null' trace_id: type: string workspace_id: type: string required: - answer_id - workspace_id - trace_id - agent_id - observed_at - scorer_id - scorer_version - execution_id type: object eval-gateway-PageMeta: type: object required: - limit - offset properties: limit: type: integer format: int32 minimum: 0 offset: type: integer format: int32 minimum: 0 total: type: - integer - 'null' format: int64 minimum: 0 securitySchemes: bearer: bearerFormat: JWT scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.