> ## 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 record versions



## OpenAPI

````yaml /public-openapi.json get /eval/v1/datasets/{dataset_id}/records/{record_id}/versions
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:
  /eval/v1/datasets/{dataset_id}/records/{record_id}/versions:
    get:
      tags:
        - Evals
      summary: List record versions
      operationId: eval.listDatasetRecordVersions
      parameters:
        - name: dataset_id
          in: path
          required: true
          schema:
            type: string
        - name: record_id
          in: path
          required: true
          schema:
            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
        - name: sort
          in: query
          required: false
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/eval-eval-PageDatasetRecordArtifactView'
          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.
        '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'
                  - 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/eval-ProblemDetails'
                  - type: object
                    required:
                      - code
                    properties:
                      code:
                        type: string
                        enum:
                          - request_timeout
          description: HTTP 504 response.
components:
  schemas:
    eval-eval-PageDatasetRecordArtifactView:
      type: object
      required:
        - items
        - page
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/eval-eval-DatasetRecordArtifactView'
        page:
          $ref: '#/components/schemas/eval-gateway-PageMeta'
    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-DatasetRecordArtifactView:
      allOf:
        - $ref: '#/components/schemas/eval-gateway-ArtifactBase'
        - oneOf:
            - $ref: '#/components/schemas/eval-eval-DatasetRecordMeta'
            - type: 'null'
        - type: object
          properties:
            permissions:
              oneOf:
                - $ref: '#/components/schemas/eval-gateway-CapabilityMatrix'
                - type: 'null'
            relationships:
              oneOf:
                - $ref: '#/components/schemas/eval-registry-RelationshipsView'
                - type: 'null'
    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-gateway-ArtifactBase:
      type: object
      required:
        - id
        - kind
        - name
        - artifact_status
        - commit_ts
        - workspace_id
        - version_ordinal
        - is_latest
        - source_type
        - created_by
        - created_at
        - updated_by
        - updated_at
      properties:
        app:
          type: string
        artifact_status:
          type: string
        commit_ts:
          type: string
        content_hash_hex:
          type:
            - string
            - 'null'
        created_at:
          type: string
        created_by:
          type: string
        current_releases:
          type:
            - object
            - 'null'
          additionalProperties:
            $ref: '#/components/schemas/eval-gateway-CurrentRelease'
          propertyNames:
            type: string
        display_name:
          type: string
        etag:
          type:
            - string
            - 'null'
        id:
          type: string
        identity:
          oneOf:
            - $ref: '#/components/schemas/eval-gateway-ArtifactIdentityRevealView'
            - type: 'null'
        is_latest:
          type: boolean
        kind:
          type: string
        name:
          type: string
        oidc_client_id:
          type:
            - string
            - 'null'
        owner_id:
          type:
            - string
            - 'null'
        project_id:
          type:
            - string
            - 'null'
        repo_id:
          type:
            - string
            - 'null'
          deprecated: true
        source_created_at:
          type:
            - string
            - 'null'
        source_created_by:
          type:
            - string
            - 'null'
        source_digest:
          type:
            - string
            - 'null'
        source_id:
          type:
            - string
            - 'null'
        source_last_modified_at:
          type:
            - string
            - 'null'
        source_last_modified_by:
          type:
            - string
            - 'null'
        source_metadata: {}
        source_synced_at:
          type:
            - string
            - 'null'
        source_type:
          type: string
        source_uri:
          type:
            - string
            - 'null'
        source_version:
          type:
            - string
            - 'null'
        updated_at:
          type: string
        updated_by:
          type: string
        uri:
          type:
            - string
            - 'null'
        version_label:
          type:
            - string
            - 'null'
        version_ordinal:
          type: integer
          format: int64
          deprecated: true
        workspace_id:
          type: string
        write_index:
          type:
            - integer
            - 'null'
          format: int64
    eval-eval-DatasetRecordMeta:
      type: object
      required:
        - dataset_id
        - input
      properties:
        categories:
          type: array
          items:
            type: string
        dataset_id:
          type: string
        display_input: {}
        expected:
          type:
            - object
            - 'null'
          additionalProperties: true
        extra:
          type:
            - object
            - 'null'
          additionalProperties: true
        input:
          type: object
          additionalProperties: true
        label:
          type:
            - string
            - 'null'
        source_kind:
          $ref: '#/components/schemas/eval-eval-RecordSource'
        source_ref:
          type:
            - string
            - 'null'
    eval-gateway-CapabilityMatrix:
      type: object
      additionalProperties:
        type: boolean
      propertyNames:
        type: string
    eval-registry-RelationshipsView:
      type: object
      required:
        - outgoing
        - incoming
        - count
      properties:
        count:
          type: integer
          minimum: 0
        incoming:
          type: array
          items:
            $ref: '#/components/schemas/eval-registry-RelationshipEdge'
        outgoing:
          type: array
          items:
            $ref: '#/components/schemas/eval-registry-RelationshipEdge'
    eval-gateway-CurrentRelease:
      type: object
      required:
        - release_id
        - version_id
      properties:
        release_id:
          type: string
        version_id:
          type: string
        version_label:
          type:
            - string
            - 'null'
    eval-gateway-ArtifactIdentityRevealView:
      type: object
      required:
        - client_id
        - credential_kind
      properties:
        api_key:
          type:
            - string
            - 'null'
        api_key_expires_at:
          type:
            - string
            - 'null'
        client_id:
          type: string
        client_secret:
          type:
            - string
            - 'null'
        credential_kind:
          type: string
    eval-eval-RecordSource:
      type: string
      enum:
        - manual
        - session
        - trace
        - external
    eval-registry-RelationshipEdge:
      type: object
      required:
        - rel_type
        - direction
        - provenance
        - relationship_status
      properties:
        attributes:
          type:
            - object
            - 'null'
          additionalProperties: {}
          propertyNames:
            type: string
        confidence:
          type:
            - number
            - 'null'
          format: double
        direction:
          type: string
        from:
          oneOf:
            - $ref: '#/components/schemas/eval-registry-EdgeTarget'
            - type: 'null'
        label:
          type:
            - string
            - 'null'
        provenance:
          type: string
        rel_type:
          type: string
        relationship_status:
          type: string
        role:
          type:
            - string
            - 'null'
        to:
          oneOf:
            - $ref: '#/components/schemas/eval-registry-EdgeTarget'
            - type: 'null'
        weight:
          type:
            - number
            - 'null'
          format: double
    eval-registry-EdgeTarget:
      type: object
      required:
        - id
        - kind
      properties:
        id:
          type: string
        is_readable:
          type: boolean
        kind:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

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