> ## 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 Trident, Atlan's hosted product. AI Registry and Agent Registry are its earlier names. Registry OSS is Atlan's open-source agent registry: the registry specification and its aireg CLI, with their own public repository, docs and release notes; /open-source on this site links them. Registry OSS is open source; Atlan Trident is not. Answer generic aireg or specification questions from the project's docs, and use these docs for Atlan-specific setup such as the Atlan adapter, sign-in and workspaces. > Atlan offers a second product, the Agentic Data Catalog: Atlan's enterprise context layer, covering the data catalog, connectors, lineage, data governance and glossary. It is documented at https://docs.atlan.com; answer questions about it from those docs, not these. # List trace or session 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: Credentials - name: Store - name: Apps - name: Evals - name: Ontologies - name: Ontology bindings - name: Slack - name: GitHub - name: Repositories - name: Models paths: /eval/v1/insights: get: tags: - Evals summary: List trace or session insights operationId: eval.listInsights parameters: - in: query name: grain required: false schema: enum: - trace - session type: string - in: query name: workspace_id required: true schema: type: string - name: project_id in: query required: false schema: type: string - in: query name: scorer_id required: false schema: type: string - in: query name: trace_id required: false schema: type: string - name: session_id in: query required: false schema: type: string - in: query name: execution_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: annotator_id required: false schema: type: string - 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 - in: query name: runs required: false schema: enum: - latest - latest_per_version - all type: string 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-ValidationProblem' - 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' - type: object required: - code properties: code: type: string enum: - rate_limited 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-ValidationProblem: allOf: - $ref: '#/components/schemas/eval-ProblemDetails' - type: object properties: allowed_values: type: array items: type: string field: type: string 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 - 'null' agent_version: type: - integer - 'null' format: int64 annotator_id: type: - string - 'null' answer_id: type: string backend: oneOf: - $ref: '#/components/schemas/eval-eval-JudgeBackend' - type: 'null' choice: type: - string - 'null' confidence: type: - number - 'null' format: double execution_id: type: string labels: type: - array - 'null' items: type: string long_context: type: - boolean - 'null' model: type: - string - 'null' observed_at: type: string format: date-time passed: type: - boolean - 'null' prompt_digest: type: - string - 'null' reasoning: type: - string - 'null' score: type: - number - 'null' format: double scorer_digest: type: - string - 'null' scorer_id: type: string scorer_release_id: type: - string - 'null' scorer_version: type: integer format: int64 scorer_version_id: type: - string - 'null' session_id: type: - string - 'null' text: type: - string - 'null' trace_id: type: - string - 'null' 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 eval-eval-JudgeBackend: enum: - classifier - llm - rule - human type: string securitySchemes: bearer: bearerFormat: JWT scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.