DecisionTrailResponse

Fields

Full decision trail for a pipeline run — the user-facing audit surface.

14 fields

below_threshold_count

integer

completed_at

string (date-time) or null

fallback_count

integer

mode_distribution

object

per_test

array of PerTestRouting

pipeline_run_id

string (uuid) or null

pipeline_status

string or null

run_id · required

string (uuid)

stages

array of StageDecisionSummary

started_at

string (date-time) or null

total_cost_usd

number

total_tokens

integer

workflow_events

array of WorkflowDecisionEvent

workflow_type

string or null

Raw schema (JSON)

{
  "description": "Full decision trail for a pipeline run — the user-facing audit surface.",
  "properties": {
    "below_threshold_count": {
      "default": 0,
      "title": "Below Threshold Count",
      "type": "integer"
    },
    "completed_at": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Completed At"
    },
    "fallback_count": {
      "default": 0,
      "title": "Fallback Count",
      "type": "integer"
    },
    "mode_distribution": {
      "additionalProperties": {
        "type": "integer"
      },
      "title": "Mode Distribution",
      "type": "object"
    },
    "per_test": {
      "items": {
        "$ref": "#/components/schemas/PerTestRouting"
      },
      "title": "Per Test",
      "type": "array"
    },
    "pipeline_run_id": {
      "anyOf": [
        {
          "format": "uuid",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Pipeline Run Id"
    },
    "pipeline_status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Pipeline Status"
    },
    "run_id": {
      "format": "uuid",
      "title": "Run Id",
      "type": "string"
    },
    "stages": {
      "items": {
        "$ref": "#/components/schemas/StageDecisionSummary"
      },
      "title": "Stages",
      "type": "array"
    },
    "started_at": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Started At"
    },
    "total_cost_usd": {
      "default": 0,
      "title": "Total Cost Usd",
      "type": "number"
    },
    "total_tokens": {
      "default": 0,
      "title": "Total Tokens",
      "type": "integer"
    },
    "workflow_events": {
      "items": {
        "$ref": "#/components/schemas/WorkflowDecisionEvent"
      },
      "title": "Workflow Events",
      "type": "array"
    },
    "workflow_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Workflow Type"
    }
  },
  "required": [
    "run_id"
  ],
  "title": "DecisionTrailResponse",
  "type": "object"
}

Used by endpoints

One endpoint sends or returns this schema, on its own or inside another schema.

• GET /api/v1/runs/{run_id}/decision-trail — AI decision trail for a test run

Used by schemas

No other schema contains this one.

More details

• Specification: OpenAPI JSON