Explain a run using retained trace evidence

{
  "data": {
    "analysis": {
      "hypotheses": [
        {
          "eventIds": [
            "string"
          ],
          "text": "string"
        }
      ],
      "limitations": [
        "string"
      ],
      "nextSteps": [
        {
          "eventIds": [
            "string"
          ],
          "text": "string"
        }
      ],
      "observations": [
        {
          "eventIds": [
            "string"
          ],
          "text": "string"
        }
      ],
      "overview": {
        "eventIds": [
          "string"
        ],
        "text": "string"
      }
    },
    "analysisExecutionId": "string",
    "analyzerVersion": 1,
    "coverageWarnings": [
      "string"
    ],
    "evidenceCount": 1,
    "executionId": "string",
    "generatedAt": "string",
    "qualityAssessment": "not_assessed"
  },
  "success": true
}

Runs a bounded, tool-free analysis in the caller account. Model usage is metered. Requires ANALYTICS:READ and FLOWS:EXECUTE for API keys. Does not assess business quality or modify the source run.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

executionIdstringRequired1-256 characters

Response

Evidence-linked run explanation

dataobject

successboolean

Errors

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error

404

Not Found Error

408

Request Timeout Error

429

Too Many Requests Error

502

Bad Gateway Error

503

Service Unavailable Error