> ## Documentation Index
> Fetch the complete documentation index at: https://docs.entire.com/llms.txt
> Use this file to discover all available pages before exploring further.

# A checkpoint's sessions as message trees



## OpenAPI

````yaml https://aws-us-east-2.api.entire.io/api/v1/openapi.json?section=sessions get /repos/{repo_id}/checkpoints/{checkpoint_id}/transcript
openapi: 3.1.0
info:
  title: Entire API
  version: 0.1.0
  description: >-
    Unified Entire API gateway. Aggregates the control plane and regional
    repository-operation services behind a single endpoint.
servers:
  - url: https://aws-us-east-2.api.entire.io/api/v1
security:
  - bearerAuth: []
tags:
  - name: search
    description: Operations under the /search surface.
  - name: semantic-search
    description: Operations under the /semantic-search surface.
  - name: brainstore
    description: Operations served by the brainstore service.
  - description: >-
      The authenticated caller's own cross-repo activity, commits, checkpoints,
      sessions, and recap.
    name: me
    x-group: Your activity
  - description: >-
      Residency-aware previews of the caller's surface, served under
      /experimental. Shapes may change without notice.
    name: experimental
  - description: >-
      Per-user settings: pinned and recent repos, diff view, and saved filter
      tabs.
    name: preferences
  - description: >-
      Repository discovery list, metadata, and headline rollups (summary,
      activity, contributors, agents).
    name: repos
  - description: >-
      Git browsing for a repo: commits, commit detail, branch compare, tree
      listings, raw file bytes, and branches.
    name: code
  - description: >-
      Checkpoint listing, resolution, LLM analysis, transcripts, and per-repo
      checkpoint status.
    name: checkpoints
    x-group: Checkpoints
  - description: >-
      Materialised sessions: listing, detail, transcripts, rename, and the
      public-share toggle.
    name: sessions
    x-group: Sessions
  - description: >-
      Repo dashboard aggregates under /overview: commit and checkpoint stats,
      contributor breakdowns, and session patterns.
    name: overview
  - description: Live ref-change stream for a repo (SSE).
    name: refs
    x-group: Ref events
  - description: >-
      Trails themselves: list, create, read, update, delete, plus per-repo
      counts, claimed branches, and the body-document ensure.
    name: trails
    x-group: Trails
  - description: >-
      What has happened on a trail: the merged timeline, the event stream, and
      who is watching (per trail, plus a repo-wide roll-up).
    name: trail-activity
    x-group: Activity
  - description: >-
      Conversation on a trail: discussions, their messages, and the live
      discussion-event stream.
    name: trail-discussions
    x-group: Discussions
  - description: >-
      Code review on a trail: review state, comments, diffs, reviewed files, and
      review re-runs.
    name: trail-reviews
    x-group: Reviews
  - description: >-
      Runner output on a trail: the latest result per configured runner, monitor
      results, and manual launches.
    name: trail-runs
  - description: >-
      Quality gates: repo gate definitions, gate settings, repo-authored monitor
      definitions, and a trail's gate evaluation.
    name: trail-gates
    x-group: Gates
  - description: >-
      Getting a trail landed: approval decisions, merge readiness, and the merge
      itself.
    name: trail-approvals
    x-group: Approvals
  - description: >-
      Trail attachment blobs: upload intent, completion, retrieval, and
      deletion.
    name: trail-attachments
  - description: Project-scoped Trails, and their owned repository Changes and discussions.
    name: projects
  - description: Agent-provenance ranking for a repo's code scopes.
    name: experts
    x-group: Experts
  - description: >-
      git-meta-compatible repo metadata read and write (git is the source of
      truth).
    name: git-meta
  - description: >-
      A project's versioned agents — what each runs (its own runner or an Entire
      preset), what it is called, the environment it runs in, the repositories
      it reviews and its trigger — and Entire's presets. Saving one runs
      nothing.
    name: agents
  - description: >-
      A project's saved, versioned Environments — where an agent runs: provider
      and sandbox lifetime — reusable across the project's repositories and
      agents. Configuration only: saving one provisions nothing.
    name: environments
  - description: >-
      Runs of a project's agents, each on one Change: starting one, the
      immutable snapshot each captured, status, output and results, retry and
      cancel.
    name: runs
  - description: >-
      Mutating repo configuration: runner, trail, public-sharing, and
      gate-enforcement settings (requires repo manage_settings for every forge).
    name: repo-settings
  - description: The caller's open pull requests across their repositories.
    name: pull-requests
  - description: 'Service-authed only: editor-document sync behind the trail body editor.'
    name: trails-internal
  - description: The runner OIDC issuer's discovery document and JWKS. Machine-consumed.
    name: runner-issuer
  - name: repositories
    x-group: Git
paths:
  /repos/{repo_id}/checkpoints/{checkpoint_id}/transcript:
    get:
      tags:
        - checkpoints
      summary: A checkpoint's sessions as message trees
      operationId: repoCheckpointTranscript
      parameters:
        - name: repo_id
          in: path
          required: true
          schema:
            type: string
        - in: path
          name: checkpoint_id
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckpointTranscriptOutputBody'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: Forbidden
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: Unprocessable Entity
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: Too Many Requests
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: Internal Server Error
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: Service Unavailable
      security:
        - oauth2: []
        - oidc: []
        - bearerAuth: []
components:
  schemas:
    CheckpointTranscriptOutputBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
            - /api/v1/schemas/CheckpointTranscriptOutputBody.json
          format: uri
          readOnly: true
          type: string
        checkpointId:
          type: string
        from_cache:
          type: boolean
        sessions:
          items:
            $ref: '#/components/schemas/SessionTranscript'
          type:
            - array
            - 'null'
        status:
          type: string
      required:
        - status
        - checkpointId
        - sessions
        - from_cache
      type: object
    ApiError:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
            - /api/v1/schemas/ApiError.json
          format: uri
          readOnly: true
          type: string
        code:
          type: string
        detail:
          type: string
        error:
          type: string
      required:
        - error
      type: object
    SessionTranscript:
      additionalProperties: false
      properties:
        agent:
          type: string
        attribution:
          $ref: '#/components/schemas/SessionAttribution'
        checkpointTranscriptStart:
          format: int64
          type:
            - integer
            - 'null'
        messages:
          items:
            $ref: '#/components/schemas/TranscriptMessage'
          type:
            - array
            - 'null'
        parsingFallback:
          type: boolean
        parsingWarning:
          type: string
        sessionId:
          type: string
        skillEvents:
          items:
            $ref: '#/components/schemas/SkillEvent'
          type:
            - array
            - 'null'
        tokenUsage:
          $ref: '#/components/schemas/SessionTokenUsage'
        transcriptIdentifierAtStart:
          type:
            - string
            - 'null'
      required:
        - sessionId
        - agent
        - messages
        - transcriptIdentifierAtStart
        - checkpointTranscriptStart
      type: object
    SessionAttribution:
      additionalProperties: false
      properties:
        agentLines:
          type: integer
          format: int64
        agentPercentage:
          type: number
          format: double
        calculatedAt:
          type: string
        humanAdded:
          type: integer
          format: int64
        humanModified:
          type: integer
          format: int64
        humanRemoved:
          type: integer
          format: int64
        totalCommitted:
          type: integer
          format: int64
      required:
        - calculatedAt
        - agentLines
        - humanAdded
        - humanModified
        - humanRemoved
        - totalCommitted
        - agentPercentage
      type: object
    TranscriptMessage:
      additionalProperties: false
      properties:
        content:
          type: string
        id:
          type: string
        images:
          items:
            $ref: '#/components/schemas/TranscriptImage'
          type:
            - array
            - 'null'
        role:
          type: string
        runtimeTags:
          items:
            $ref: '#/components/schemas/TranscriptRuntimeTag'
          type:
            - array
            - 'null'
        skillInvocation:
          $ref: '#/components/schemas/TranscriptSkillInvocation'
        timestamp:
          type: string
        toolCalls:
          items:
            $ref: '#/components/schemas/ToolCall'
          type:
            - array
            - 'null'
      required:
        - id
        - role
        - content
        - timestamp
      type: object
    SkillEvent:
      additionalProperties: false
      properties:
        collapse:
          $ref: '#/components/schemas/SkillCollapse'
        eventType:
          type: string
        id:
          type: string
        native:
          additionalProperties:
            type: string
          type: object
        skill:
          $ref: '#/components/schemas/SkillEventSkill'
        source:
          $ref: '#/components/schemas/TranscriptSkillSource'
        timestamp:
          type: string
        transcriptAnchor:
          $ref: '#/components/schemas/SkillTranscriptAnchor'
        turnId:
          type: string
      required:
        - eventType
        - skill
      type: object
    SessionTokenUsage:
      additionalProperties: false
      properties:
        inputTokens:
          type: integer
          format: int64
        outputTokens:
          type: integer
          format: int64
      required:
        - inputTokens
        - outputTokens
      type: object
    TranscriptImage:
      additionalProperties: false
      properties:
        data:
          type: string
        mediaType:
          type: string
      required:
        - mediaType
        - data
      type: object
    TranscriptRuntimeTag:
      additionalProperties: false
      properties:
        content:
          type: string
        tag:
          type: string
      required:
        - tag
        - content
      type: object
    TranscriptSkillInvocation:
      additionalProperties: false
      properties:
        collapseTarget:
          type: string
        defaultCollapsed:
          type: boolean
        eventId:
          type: string
        eventType:
          type: string
        label:
          type: string
        skillName:
          type: string
        source:
          $ref: '#/components/schemas/TranscriptSkillSource'
      required:
        - eventType
        - skillName
      type: object
    ToolCall:
      additionalProperties: false
      properties:
        categories:
          items:
            description: >-
              Open timeline filter category. Clients must tolerate values added
              in the future.
            type: string
            x-open-enum:
              - fileEdits
              - bash
              - read
              - skills
              - entire
              - other
          type:
            - array
            - 'null'
        id:
          type: string
        input:
          additionalProperties: {}
          type: object
        metadata:
          $ref: '#/components/schemas/ToolCallMetadata'
        name:
          type: string
        operations:
          items:
            $ref: '#/components/schemas/ToolCall'
          type:
            - array
            - 'null'
        result:
          $ref: '#/components/schemas/ToolCallResult'
        skillInvocation:
          $ref: '#/components/schemas/TranscriptSkillInvocation'
        timestamp:
          type: string
      required:
        - timestamp
        - id
        - name
        - input
      type: object
    SkillCollapse:
      additionalProperties: false
      properties:
        defaultCollapsed:
          type: boolean
        label:
          type: string
        target:
          type: string
      type: object
    SkillEventSkill:
      additionalProperties: false
      properties:
        name:
          type: string
      required:
        - name
      type: object
    TranscriptSkillSource:
      additionalProperties: false
      properties:
        agent:
          type: string
        confidence:
          type: string
        signal:
          type: string
      type: object
    SkillTranscriptAnchor:
      additionalProperties: false
      properties:
        end:
          type: integer
          format: int64
        entryIds:
          items:
            type: string
          type:
            - array
            - 'null'
        start:
          type: integer
          format: int64
        toolUseId:
          type: string
        unit:
          type: string
      type: object
    ToolCallMetadata:
      additionalProperties: false
      properties:
        mcpServer:
          type: string
      type: object
    ToolCallResult:
      additionalProperties: false
      properties:
        answers:
          additionalProperties:
            type: string
          type: object
        error:
          type: string
        file:
          $ref: '#/components/schemas/ToolResultFile'
        matchCount:
          type: integer
          format: int64
        output:
          type: string
        type:
          type: string
      required:
        - type
      type: object
    ToolResultFile:
      additionalProperties: false
      properties:
        filePath:
          type: string
        numLines:
          type: integer
          format: int64
      required:
        - filePath
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: JWT
      description: >-
        Bearer token authorizing this operation's repository action. Each
        operation's security requirement names the resource action the token
        must be authorized for (pull or push).
      scheme: bearer
      type: http
    oauth2:
      description: OAuth 2.0 authorization code flow.
      flows:
        authorizationCode:
          authorizationUrl: https://us.auth.entire.io/authorize
          scopes:
            offline_access: Stay signed in and receive a refresh token.
            openid: Verify your identity.
          tokenUrl: https://us.auth.entire.io/oauth/token
      type: oauth2
    oidc:
      description: >-
        OpenID Connect discovery document:
        https://us.auth.entire.io/.well-known/openid-configuration
      openIdConnectUrl: https://us.auth.entire.io/.well-known/openid-configuration
      type: openIdConnect

````