LangChain runs API

openapi: 3.2.0
info:
  title: LangSmith access_policies Runs API
  description: 'The LangSmith API is used to programmatically create and manage LangSmith resources.


    ## Host

    https://api.smith.langchain.com


    ## Authentication

    To authenticate with the LangSmith API, set the `X-Api-Key` header

    to a valid [LangSmith API key](https://docs.langchain.com/langsmith/create-account-api-key#create-an-api-key).


    '
  version: 0.1.0
servers:
- url: /
tags:
- name: runs
paths:
  /runs:
    post:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      description: Queues a single run for ingestion. The request body must be a JSON-encoded run object that follows the Run schema.
      tags:
      - runs
      summary: Create a Run
      parameters: []
      responses:
        '202':
          description: Run created
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  allOf:
                  - type: string
                  - type: object
                    properties:
                      message:
                        type: string
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
        '422':
          description: Unprocessable Entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/runs.Run'
  /runs/batch:
    post:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      description: 'Ingests a batch of runs in a single JSON payload. The payload must have `post` and/or `patch` arrays containing run objects.

        Prefer this endpoint over single‑run ingestion when submitting hundreds of runs, but `/runs/multipart` offers better handling for very large fields and attachments.'
      tags:
      - runs
      summary: Ingest Runs (Batch JSON)
      parameters: []
      responses:
        '202':
          description: Runs batch ingested
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  allOf:
                  - type: string
                  - type: object
                    properties:
                      message:
                        type: string
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
        '422':
          description: Unprocessable Entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                patch:
                  type: array
                  items:
                    $ref: '#/components/schemas/runs.Run'
                post:
                  type: array
                  items:
                    $ref: '#/components/schemas/runs.Run'
  /runs/multipart:
    post:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      description: 'Ingests multiple runs, feedback objects, and binary attachments in a single `multipart/form-data` request.

        **Part‑name pattern**: `<event>.<run_id>[.<field>]` where `event` ∈ {`post`, `patch`, `feedback`, `attachment`}.

        * `post|patch.<run_id>` – JSON run payload.

        * `post|patch.<run_id>.<field>` – out‑of‑band run data (`inputs`, `outputs`, `events`, `error`, `extra`, `serialized`).

        * `feedback.<run_id>` – JSON feedback payload (must include `trace_id`).

        * `attachment.<run_id>.<filename>` – arbitrary binary attachment stored in S3.

        **Headers**: every part must set `Content-Type` **and** either a `Content-Length` header or `length` parameter. Per‑part `Content-Encoding` is **not** allowed; the top‑level request may be `Content-Encoding: gzip` or `Content-Encoding: zstd`.

        **Best performance** for high‑volume ingestion.'
      tags:
      - runs
      summary: Ingest Runs (Multipart)
      parameters: []
      responses:
        '202':
          description: Accepted
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  type: string
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
        '422':
          description: Unprocessable Entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                post.{run_id}:
                  type: string
                  format: binary
                  description: Run to create (JSON)
                patch.{run_id}:
                  type: string
                  format: binary
                  description: Run to update (JSON)
                post.{run_id}.inputs:
                  type: string
                  format: binary
                  description: Large inputs object (JSON) stored out‑of‑band
                patch.{run_id}.outputs:
                  type: string
                  format: binary
                  description: Large outputs object (JSON) stored out‑of‑band
                feedback.{run_id}:
                  type: string
                  format: binary
                  description: Feedback object (JSON) – must include trace_id
                attachment.{run_id}.{filename}:
                  type: string
                  format: binary
                  description: Binary attachment linked to run {run_id}
  /runs/{run_id}:
    patch:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      description: Updates a run identified by its ID. The body should contain only the fields to be changed; unknown fields are ignored.
      tags:
      - runs
      summary: Update a Run
      parameters:
      - description: Run ID
        name: run_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '202':
          description: Run updated
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  allOf:
                  - type: string
                  - type: object
                    properties:
                      message:
                        type: string
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
        '422':
          description: Unprocessable Entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runs.ErrorResponse'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/runs.Run'
  /v2/runs/query:
    post:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      description: '**Alpha:** The request and response contract may change;

        Returns a paginated list of runs for the given projects within min/max start_time. Supports filters, cursor pagination, and `selects` to select fields to return.'
      tags:
      - runs
      summary: Query runs
      parameters:
      - description: application/json
        name: Accept
        in: header
        schema:
          type: string
      - description: application/json (required for JSON body)
        name: Content-Type
        in: header
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/query.QueryRunsResponseBody'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  type: string
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/query.QueryRunsRequestBody'
  /v2/runs/{run_id}:
    get:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      description: '**Alpha:** The request and response contract may change;

        Returns one run by ID for the given session and start_time. Use the `selects` query parameter (repeatable) to select fields to return.'
      tags:
      - runs
      summary: Get a single run
      parameters:
      - description: application/json
        name: Accept
        in: header
        schema:
          type: string
      - description: Run UUID
        name: run_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - description: '`project_id` is the UUID of the tracing project that owns the run.'
        name: project_id
        in: query
        required: true
        schema:
          type: string
          format: uuid
          title: Project Id
      - description: '`selects` lists which properties to include on the returned run (repeatable query parameter). Accepts any value of the `RunSelectField` enum. If omitted, only `id` is returned.'
        name: selects
        in: query
        style: form
        explode: true
        schema:
          type: array
          items:
            enum:
            - ID
            - NAME
            - RUN_TYPE
            - STATUS
            - START_TIME
            - END_TIME
            - LATENCY_SECONDS
            - FIRST_TOKEN_TIME
            - ERROR
            - ERROR_PREVIEW
            - EXTRA
            - METADATA
            - EVENTS
            - INPUTS
            - INPUTS_PREVIEW
            - OUTPUTS
            - OUTPUTS_PREVIEW
            - MANIFEST
            - PARENT_RUN_IDS
            - PROJECT_ID
            - TRACE_ID
            - THREAD_ID
            - DOTTED_ORDER
            - IS_ROOT
            - REFERENCE_EXAMPLE_ID
            - REFERENCE_DATASET_ID
            - TOTAL_TOKENS
            - PROMPT_TOKENS
            - COMPLETION_TOKENS
            - TOTAL_COST
            - PROMPT_COST
            - COMPLETION_COST
            - PROMPT_TOKEN_DETAILS
            - COMPLETION_TOKEN_DETAILS
            - PROMPT_COST_DETAILS
            - COMPLETION_COST_DETAILS
            - PRICE_MODEL_ID
            - TAGS
            - APP_PATH
            - ATTACHMENTS
            - THREAD_EVALUATION_TIME
            - IS_IN_DATASET
            - SHARE_URL
            - FEEDBACK_STATS
            type: string
          title: Selects
      - description: '`start_time` is the run''s `start_time` (RFC3339 date-time), used together with `project_id` to locate the run.'
        name: start_time
        in: query
        required: true
        schema:
          type: string
          format: date-time
          title: Start Time
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/query.RunResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  type: string
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  type: string
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  type: string
  /v2/traces/{trace_id}/runs:
    get:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      description: '**Alpha:** The request and response contract may change;

        Returns runs for a trace ID within min/max start time. Optional `filter`; repeatable `selects` to select fields to return.'
      tags:
      - runs
      summary: List runs in a trace
      parameters:
      - description: application/json
        name: Accept
        in: header
        schema:
          type: string
      - description: Trace UUID
        name: trace_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - description: '`filter` narrows which runs within this trace are returned, using a LangSmith filter expression evaluated against each run. For example: `eq(run_type, "llm")` for LLM runs only, or `eq(status, "error")` for failed runs.

          See https://docs.langchain.com/langsmith/trace-query-syntax#filter-query-language for syntax.'
        name: filter
        in: query
        schema:
          type: string
          title: Filter
      - description: '`max_start_time` is the inclusive upper bound for run `start_time` (RFC3339 date-time).'
        name: max_start_time
        in: query
        required: true
        schema:
          type: string
          format: date-time
          title: Max Start Time
      - description: '`min_start_time` is the inclusive lower bound for run `start_time` (RFC3339 date-time).'
        name: min_start_time
        in: query
        required: true
        schema:
          type: string
          format: date-time
          title: Min Start Time
      - description: '`project_id` is the UUID of the tracing project that owns the trace.'
        name: project_id
        in: query
        required: true
        schema:
          type: string
          format: uuid
          title: Project Id
      - description: '`selects` lists which properties to include on each returned run (repeatable query parameter). Accepts any value of the `RunSelectField` enum. If omitted, only `id` is returned.'
        name: selects
        in: query
        style: form
        explode: true
        schema:
          type: array
          items:
            enum:
            - ID
            - NAME
            - RUN_TYPE
            - STATUS
            - START_TIME
            - END_TIME
            - LATENCY_SECONDS
            - FIRST_TOKEN_TIME
            - ERROR
            - ERROR_PREVIEW
            - EXTRA
            - METADATA
            - EVENTS
            - INPUTS
            - INPUTS_PREVIEW
            - OUTPUTS
            - OUTPUTS_PREVIEW
            - MANIFEST
            - PARENT_RUN_IDS
            - PROJECT_ID
            - TRACE_ID
            - THREAD_ID
            - DOTTED_ORDER
            - IS_ROOT
            - REFERENCE_EXAMPLE_ID
            - REFERENCE_DATASET_ID
            - TOTAL_TOKENS
            - PROMPT_TOKENS
            - COMPLETION_TOKENS
            - TOTAL_COST
            - PROMPT_COST
            - COMPLETION_COST
            - PROMPT_TOKEN_DETAILS
            - COMPLETION_TOKEN_DETAILS
            - PROMPT_COST_DETAILS
            - COMPLETION_COST_DETAILS
            - PRICE_MODEL_ID
            - TAGS
            - APP_PATH
            - ATTACHMENTS
            - THREAD_EVALUATION_TIME
            - IS_IN_DATASET
            - SHARE_URL
            - FEEDBACK_STATS
            type: string
          title: Selects
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/query.QueryTraceResponseBody'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  type: string
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  type: string
components:
  schemas:
    query.RunPromptTokenDetails:
      type: object
      properties:
        raw:
          description: '`raw` maps each category name to its prompt-token count.'
          type: object
          additionalProperties:
            type: integer
            format: int64
    query.RunCompletionTokenDetails:
      type: object
      properties:
        raw:
          description: '`raw` maps each category name to its completion-token count.'
          type: object
          additionalProperties:
            type: integer
            format: int64
    runs.Run:
      type: object
      properties:
        dotted_order:
          type: string
        end_time:
          type: string
        error:
          type: string
        events:
          type: array
          items:
            type: object
            additionalProperties: true
        extra:
          type: object
          additionalProperties: true
        id:
          type: string
        input_attachments:
          type: object
          additionalProperties: true
        inputs:
          type: object
          additionalProperties: true
        name:
          type: string
        output_attachments:
          type: object
          additionalProperties: true
        outputs:
          type: object
          additionalProperties: true
        parent_run_id:
          type: string
        reference_example_id:
          type: string
        run_type:
          type: string
          enum:
          - tool
          - chain
          - llm
          - retriever
          - embedding
          - prompt
          - parser
        serialized:
          type: object
          additionalProperties: true
        session_id:
          type: string
        session_name:
          type: string
        start_time:
          type: string
        status:
          type: string
        tags:
          type: array
          items:
            type: string
        trace_id:
          type: string
    query.RunType:
      type: string
      enum:
      - TOOL
      - CHAIN
      - LLM
      - RETRIEVER
      - EMBEDDING
      - PROMPT
      - PARSER
      x-enum-varnames:
      - RunTypeTool
      - RunTypeChain
      - RunTypeLLM
      - RunTypeRetriever
      - RunTypeEmbedding
      - RunTypePrompt
      - RunTypeParser
    query.RunSelectField:
      type: string
      enum:
      - ID
      - NAME
      - RUN_TYPE
      - STATUS
      - START_TIME
      - END_TIME
      - LATENCY_SECONDS
      - FIRST_TOKEN_TIME
      - ERROR
      - ERROR_PREVIEW
      - EXTRA
      - METADATA
      - EVENTS
      - INPUTS
      - INPUTS_PREVIEW
      - OUTPUTS
      - OUTPUTS_PREVIEW
      - MANIFEST
      - PARENT_RUN_IDS
      - PROJECT_ID
      - TRACE_ID
      - THREAD_ID
      - DOTTED_ORDER
      - IS_ROOT
      - REFERENCE_EXAMPLE_ID
      - REFERENCE_DATASET_ID
      - TOTAL_TOKENS
      - PROMPT_TOKENS
      - COMPLETION_TOKENS
      - TOTAL_COST
      - PROMPT_COST
      - COMPLETION_COST
      - PROMPT_TOKEN_DETAILS
      - COMPLETION_TOKEN_DETAILS
      - PROMPT_COST_DETAILS
      - COMPLETION_COST_DETAILS
      - PRICE_MODEL_ID
      - TAGS
      - APP_PATH
      - ATTACHMENTS
      - THREAD_EVALUATION_TIME
      - IS_IN_DATASET
      - SHARE_URL
      - FEEDBACK_STATS
      x-enum-varnames:
      - RunSelectID
      - RunSelectName
      - RunSelectRunType
      - RunSelectStatus
      - RunSelectStartTime
      - RunSelectEndTime
      - RunSelectLatencySeconds
      - RunSelectFirstTokenTime
      - RunSelectError
      - RunSelectErrorPreview
      - RunSelectExtra
      - RunSelectMetadata
      - RunSelectEvents
      - RunSelectInputs
      - RunSelectInputsPreview
      - RunSelectOutputs
      - RunSelectOutputsPreview
      - RunSelectManifest
      - RunSelectParentRunIDs
      - RunSelectProjectID
      - RunSelectTraceID
      - RunSelectThreadID
      - RunSelectDottedOrder
      - RunSelectIsRoot
      - RunSelectReferenceExampleID
      - RunSelectReferenceDatasetID
      - RunSelectTotalTokens
      - RunSelectPromptTokens
      - RunSelectCompletionTokens
      - RunSelectTotalCost
      - RunSelectPromptCost
      - RunSelectCompletionCost
      - RunSelectPromptTokenDetails
      - RunSelectCompletionTokenDetails
      - RunSelectPromptCostDetails
      - RunSelectCompletionCostDetails
      - RunSelectPriceModelID
      - RunSelectTags
      - RunSelectAppPath
      - RunSelectAttachments
      - RunSelectThreadEvaluationTime
      - RunSelectIsInDataset
      - RunSelectShareURL
      - RunSelectFeedbackStats
    query.RunFeedbackStats:
      type: object
      additionalProperties:
        $ref: '#/components/schemas/query.RunFeedbackStat'
    query.RunAttachmentURLs:
      type: object
      additionalProperties:
        type: string
    query.QueryRunsRequestBody:
      type: object
      properties:
        ai_query:
          description: '`ai_query` is a natural-language query to filter runs using AI.'
          type: string
          example: runs that used tool calls
        cursor:
          description: '`cursor` is the opaque string from a previous response''s `next_cursor`.'
          type: string
          example: eyJsYXN0X2lkIjoiMDE4ZTRjN2UtYTlmYi03ZWYwLWE1YjYtNmVhM2E4MmU5MzI3In0=
        filter:
          description: '`filter` narrows results to runs matching this LangSmith filter expression, evaluated against each individual run.

            For example: and(eq(run_type, "llm"), gt(latency, 5)) or eq(status, "error").

            See https://docs.langchain.com/langsmith/trace-query-syntax#filter-query-language for syntax.'
          type: string
          example: and(eq(run_type, "llm"), gt(latency, 5))
        has_error:
          description: '`has_error` filters to runs that errored (true) or completed without error (false).'
          type: boolean
          example: false
        ids:
          description: '`ids` optionally limits the request to these run UUIDs.'
          type: array
          items:
            type: string
            format: uuid
          example:
          - 018e4c7e-a9fb-7ef0-a5b6-6ea3a82e9327
          - f47ac10b-58cc-4372-a567-0e02b2c3d479
        is_root:
          description: '`is_root` returns only root runs (true) or only non-root runs (false).'
          type: boolean
          example: true
        max_start_time:
          description: '`max_start_time` is the upper bound for run `start_time` (RFC3339). Defaults to now.'
          type: string
          format: date-time
          example: '2024-12-31T23:59:59Z'
        min_start_time:
          description: '`min_start_time` is the lower bound for run `start_time` (RFC3339). Defaults to 1 day ago.'
          type: string
          format: date-time
          example: '2024-01-01T00:00:00Z'
        page_size:
          description: '`page_size` is the maximum number of runs to return in this response. Defaults to 100 when omitted; must be between 1 and 1000 inclusive when set.'
          type: integer
          default: 100
          maximum: 1000
          minimum: 1
          example: 100
        project_ids:
          description: '`project_ids` lists tracing project UUIDs to query.'
          type: array
          items:
            type: string
            format: uuid
          example:
          - 018e4c7e-a9fb-7ef0-a5b6-6ea3a82e9327
          - 0190a1b2-c3d4-7ef0-a5b6-6ea3a82e9328
        reference_examples:
          description: '`reference_examples` optionally limits to runs linked to these dataset example UUIDs.'
          type: array
          items:
            type: string
            format: uuid
          example:
          - b2c3d4e5-f6a7-4b5c-9d0e-1f2a3b4c5d6e
          - c3d4e5f6-a7b8-4c5d-0e1f-2a3b4c5d6e7f
        run_type:
          description: '`run_type`, when set, restricts results to runs whose `run_type` equals this value.'
          allOf:
          - $ref: '#/components/schemas/query.RunType'
          example: LLM
        selects:
          description: '`selects` lists which properties to include on each returned run. If omitted, only `id` is returned. Properties not listed are omitted from each run object.'
          type: array
          items:
            $ref: '#/components/schemas/query.RunSelectField'
          example:
          - ID
          - NAME
          - PROJECT_ID
          - START_TIME
          - RUN_TYPE
          - STATUS
        sort_order:
          description: '`sort_order` is the sort direction for `start_time` (`ASC` or `DESC`). Defaults to `DESC` when omitted. Maps to the SmithDB proto `Order` field.'
          default: DESC
          allOf:
          - $ref: '#/components/schemas/query.SortOrder'
          example: DESC
        trace_filter:
          description: '`trace_filter` narrows results to runs whose root trace matches this LangSmith filter expression.

            Use this to filter by properties of the trace''s root run — for example eq(status, "success") to include only traces that completed without error.

            See https://docs.langchain.com/langsmith/trace-query-syntax#filter-query-language for syntax.'
          type: string
          example: eq(status, "success")
        trace_id:
          description: '`trace_id` optionally limits results to runs belonging to this trace UUID.'
          type: string
          format: uuid
          example: f47ac10b-58cc-4372-a567-0e02b2c3d479
        tree_filter:
          description: '`tree_filter` narrows results to runs that belong to a trace containing at least one run matching this LangSmith filter expression anywhere in the run tree (not just the root).

            Use this to find runs inside traces that involved a specific tool, tag, or model — for example has(tags, "production") or eq(name, "my_tool").

            See https://docs.langchain.com/langsmith/trace-query-syntax#filter-query-language for syntax.'
          type: string
          example: has(tags, "production")
    query.RunEvent:
      type: object
      properties:
        kwargs:
          description: '`kwargs` is the event payload — an opaque JSON object whose shape depends on `name` and on the emitting SDK. For example LangChain emits `{"token": {...}}` for `new_token` events, tool-call start/end details for tool events, and arbitrary user-defined payloads for custom events. Clients should treat `kwargs` as untyped JSON: do not assume specific keys exist for a given `name`, and tolerate additional unknown keys appearing over time.'
          type: object
        name:
          description: '`name` is the event kind. Common values emitted by the LangChain/LangSmith tracer SDKs include `"start"`, `"end"`, and `"new_token"`, but applications may emit arbitrary strings for their own instrumentation.'
          type: string
          example: new_token
        time:
          description: '`time` is when the event occurred (RFC3339 date-time with millisecond precision).'
          type: string
          format: date-time
          example: '2024-01-15T10:30:00.312Z'
    query.RunStatus:
      type: string
      enum:
      - SUCCESS
      - ERROR
      - PENDING
      x-enum-varnames:
      - RunStatusSuccess
      - RunStatusError
      - RunStatusPending
    query.SortOrder:
      type: string
      enum:
      - ASC
      - DESC
      x-enum-varnames:
      - SortOrderAsc
      - SortOrderDesc
    query.RunResponse:
      type: object
      properties:
        app_path:
          description: '`app_path` identifies the application code location that produced this run, if recorded.'
          type: string
          example: /app/chains/chat.py:invoke
        attachments:
          description: '`attachments` maps each attachment file name to a pre-signed HTTPS download URL.'
          allOf:
          - $ref: '#/components/schemas/query.RunAttachmentURLs'
          example:
            '{"output.png"': '"https://storage.example.com/bucket/key?X-Amz-Signature=abc"}'
        completion_cost:
          description: '`completion_cost` is estimated USD cost for the completion.'
          type: number
          example: 0.0003
        completion_cost_details:
          description: '`completion_cost_details` is the per-category USD breakdown of `completion_cost`. Categories mirror `completion_token_details`. Returned only when the `COMPLETION_COST_DETAILS` field is requested.'
          allOf:
          - $ref: '#/components/schemas/query.RunCompletionCostDetails'
        completion_token_details:
          description: '`completion_token_details` is the per-category breakdown of `completion_tokens`. Category names are model-specific (for example `reasoning`, `audio`). Returned only when the `COMPLETION_TOKEN_DETAILS` field is requested.'
          allOf:
          - $ref: '#/components/schemas/query.RunCompletionTokenDetails'
        completion_tokens:
          description: '`completion_tokens` is the completion-side token count.'
          type: integer
          example: 150
        dotted_order:
          description: '`dotted_order` is the hierarchical ordering key for trace trees.'
          type: string
          example: 20240115T103000000000Z018e4c7ea9fb7ef0a5b66ea3

# --- truncated at 32 KB (44 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/langchain/refs/heads/main/openapi/langchain-runs-api-openapi.yml