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

# Get run details

> Full audit trail for a run including output, steps (tool calls, text), and token usage.



## OpenAPI

````yaml /openapi.json get /agent/v1/run/{id}/details
openapi: 3.1.0
info:
  title: Case.dev API
  description: >-
    The AI-native platform for legal technology. Build smarter legal
    applications with our suite of AI-powered APIs.
  version: 1.0.0
  contact:
    name: Case.dev Support
    email: support@casemark.com
    url: https://case.dev
  license:
    name: Proprietary
    url: https://case.dev/terms
servers:
  - url: https://api.case.dev
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Vaults
    description: Secure document storage with semantic search and GraphRAG
  - name: Memory
    description: >-
      Persistent memory for AI agents with semantic search and 12 generic
      indexed tag fields
  - name: OCR
    description: Extract text from PDFs, images, and scanned documents
  - name: Voice
    description: Audio transcription and text-to-speech
  - name: LLMs
    description: Access 40+ language models through a unified API
  - name: Search
    description: Web search, AI answers, and deep research
  - name: Mail
    description: Managed inboxes for agent email workflows
  - name: Media
    description: Transcript retrieval and captioned media clip generation
  - name: Legal
    description: Legal research tools including citation verification
  - name: Privilege
    description: Privilege detection for e-discovery and litigation workflows
  - name: Compute
    description: Serverless GPU and CPU infrastructure
  - name: Format
    description: Document formatting and template rendering (MD/JSON to PDF/DOCX)
  - name: SuperDoc
    description: Document conversion and template automation
  - name: Webhooks
    description: Webhook endpoint management
  - name: System
    description: Public system metadata and discovery endpoints
  - name: Usage
    description: Usage reporting and webhook subscriptions
  - name: Database
    description: Serverless PostgreSQL databases with instant branching
  - name: Translation
    description: Language detection and translation for multilingual legal workflows
  - name: Skills
    description: Search and read legal AI skills for agents
  - name: Agents
    description: >-
      Create, manage, and execute AI agents with tool access, sandbox
      environments, and async run workflows
  - name: Matters
    description: Matter-native legal workspaces and orchestration primitives
  - name: Applications Projects
    description: Web application project management
  - name: Applications Deployments
    description: Web application deployment management
  - name: Applications Domains
    description: Custom domain configuration for applications
  - name: Applications Env Vars
    description: Environment variable management for applications
paths:
  /agent/v1/run/{id}/details:
    get:
      tags:
        - Agents
      summary: Get run details
      description: >-
        Full audit trail for a run including output, steps (tool calls, text),
        and token usage.
      operationId: getAgentRunDetails
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: Run ID
      responses:
        '200':
          description: Run details with full step trace
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  agentId:
                    type: string
                  status:
                    type: string
                    enum:
                      - queued
                      - running
                      - completed
                      - failed
                      - cancelled
                  prompt:
                    type: string
                  guidance:
                    type: string
                    nullable: true
                  model:
                    type: string
                    nullable: true
                  workflowId:
                    type: string
                    nullable: true
                    description: Durable workflow run ID
                  modalSandboxId:
                    type: string
                    nullable: true
                    deprecated: true
                    description: >-
                      Deprecated legacy Modal sandbox ID. Prefer `provider` and
                      `runtimeId`.
                  provider:
                    type: string
                    nullable: true
                    enum:
                      - daytona
                      - vercel
                    description: Runtime provider for this run
                  runtimeId:
                    type: string
                    nullable: true
                    description: Provider-specific runtime identifier
                  runtimeState:
                    type: string
                    nullable: true
                    enum:
                      - running
                      - stopped
                      - archived
                      - ended
                      - error
                    description: Current runtime state, when available
                  result:
                    type: object
                    nullable: true
                    description: Final output from the agent
                    properties:
                      output:
                        type: string
                      outputObjectIds:
                        type: array
                        items:
                          type: string
                      finalResponse:
                        type: object
                        nullable: true
                        description: >-
                          Compact agent-facing result summary and execution
                          issues
                        properties:
                          summary:
                            type: string
                          createdObjectIds:
                            type: array
                            items:
                              type: string
                          issues:
                            type: array
                            items:
                              type: string
                      logs:
                        type: object
                        nullable: true
                        description: >-
                          Sandbox execution logs (runtime server + runner
                          script)
                        properties:
                          runtime:
                            type: string
                            description: Runtime server stdout/stderr
                          opencode:
                            type: string
                            description: Legacy runtime server stdout/stderr
                          runner:
                            type: string
                            description: Runner script stdout/stderr
                  usage:
                    type: object
                    nullable: true
                    description: Token usage statistics
                    properties:
                      model:
                        type: string
                      inputTokens:
                        type: integer
                      outputTokens:
                        type: integer
                      toolCalls:
                        type: integer
                      durationMs:
                        type: integer
                      summary:
                        type: object
                        nullable: true
                        properties:
                          costMicros:
                            type: integer
                          totalInputTokens:
                            type: integer
                          totalOutputTokens:
                            type: integer
                          totalTokens:
                            type: integer
                      entries:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            kind:
                              type: string
                              enum:
                                - llm
                                - api
                            service:
                              type: string
                            endpoint:
                              type: string
                              nullable: true
                            method:
                              type: string
                              nullable: true
                            statusCode:
                              type: integer
                              nullable: true
                            costMicros:
                              type: integer
                            promptTokens:
                              type: integer
                              nullable: true
                            completionTokens:
                              type: integer
                              nullable: true
                            totalTokens:
                              type: integer
                              nullable: true
                            model:
                              type: string
                              nullable: true
                            timestamp:
                              type: string
                              format: date-time
                            metadata:
                              nullable: true
                  steps:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        type:
                          type: string
                          enum:
                            - output
                            - thinking
                            - tool_call
                            - tool_result
                        content:
                          type: string
                          nullable: true
                        toolName:
                          type: string
                          nullable: true
                        toolInput:
                          nullable: true
                        toolOutput:
                          nullable: true
                        durationMs:
                          type: integer
                          nullable: true
                        timestamp:
                          type: string
                          format: date-time
                  createdAt:
                    type: string
                    format: date-time
                  startedAt:
                    type: string
                    format: date-time
                    nullable: true
                  completedAt:
                    type: string
                    format: date-time
                    nullable: true
        '400':
          description: Missing run ID
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  statusMessage:
                    type: string
                  message:
                    type: string
        '401':
          description: Invalid API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  statusMessage:
                    type: string
                  message:
                    type: string
        '403':
          description: No agent access
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  statusMessage:
                    type: string
                  message:
                    type: string
        '404':
          description: Run not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  statusMessage:
                    type: string
                  message:
                    type: string
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API key starting with `sk_case_`

````