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

# Get a run's trace outline

> The span tree of one run via the contract's ``get_trace``: every span without its input and output.

An absent trace is a 404 and a read the backend cannot serve a 501, exactly as ``get_run_trace``.



## OpenAPI

````yaml /openapi.json get /api/observability/runs/{trace_id}/trace/outline
openapi: 3.1.0
info:
  description: >-
    The operator HTTP surface served under /api/*. The platform's core routes.
    Plugin routes are published by each plugin.
  title: tai42-skeleton API
  version: 23.0.0
servers: []
security: []
paths:
  /api/observability/runs/{trace_id}/trace/outline:
    get:
      tags:
        - observability
      summary: Get a run's trace outline
      description: >-
        The span tree of one run via the contract's ``get_trace``: every span
        without its input and output.


        An absent trace is a 404 and a read the backend cannot serve a 501,
        exactly as ``get_run_trace``.
      operationId: get_api_observability_runs_trace_id_trace_outline
      parameters:
        - in: path
          name: trace_id
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    $ref: '#/components/schemas/RunTraceOutlineView'
                required:
                  - data
                type: object
          description: Success.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Missing or invalid api key.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Resource not found.
        '501':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Error.
      security:
        - ApiKeyAuth: []
components:
  schemas:
    RunTraceOutlineView:
      description: 'The span tree of one run: every span without its input and output.'
      properties:
        spans:
          items:
            $ref: '#/components/schemas/SpanOutlineView'
          title: Spans
          type: array
        traceId:
          title: Traceid
          type: string
      required:
        - traceId
        - spans
      title: RunTraceOutlineView
      type: object
    Error:
      properties:
        code:
          description: >-
            Stable machine-readable reason a client keys a dedicated error state
            on, present on refusals that opt in (e.g. a 501 not-configured
            refusal). Optional: absent when the error carries only a
            human-readable message.
          type: string
        error:
          type: string
      required:
        - error
      type: object
    SpanOutlineView:
      description: >-
        One span within a run trace, without its input and output.


        ``kind`` is the backend's observation type mapped onto the neutral
        kinds; the token

        counts are ``null`` when the producer reported none. ``metadata`` is the
        producer's

        metadata (open JSON), passed through whole, the platform reading no key
        out of it.
      properties:
        end:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: End
        id:
          title: Id
          type: string
        inputTokens:
          anyOf:
            - type: integer
            - type: 'null'
          default: null
          title: Inputtokens
        kind:
          anyOf:
            - enum:
                - LLM
                - TOOL
                - CHAIN
                - EVENT
              type: string
            - type: 'null'
          default: null
          title: Kind
        level:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Level
        metadata:
          $ref: '#/components/schemas/JsonValue'
          default: null
        model:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Model
        name:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Name
        outputTokens:
          anyOf:
            - type: integer
            - type: 'null'
          default: null
          title: Outputtokens
        parentId:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Parentid
        start:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Start
        statusMessage:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Statusmessage
        totalTokens:
          anyOf:
            - type: integer
            - type: 'null'
          default: null
          title: Totaltokens
        traceId:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Traceid
      required:
        - id
      title: SpanOutlineView
      type: object
    JsonValue: {}
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: x-api-key
      type: apiKey

````

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