List Deep Research runs

List the caller’s Deep Research runs attached to an agent thread.

GET /api/v1/ee/projects/{projectUuid}/ai-deep-research

Error

A valid request URL is required to generate request examples

200

{
  "results": [
    {
      "completedAt": "<string>",
      "startedAt": "<string>",
      "updatedAt": "<string>",
      "createdAt": "<string>",
      "cancellationRequestedAt": "<string>",
      "errorMessage": "<string>",
      "budget": {
        "maxResultRows": 123,
        "maxWarehouseQueries": 123,
        "maxToolCalls": 123,
        "maxTokens": 123,
        "maxRuntimeMs": 123
      },
      "resultChartData": {},
      "resultMarkdown": "<string>",
      "prompt": "<string>",
      "promptUuid": "<string>",
      "aiThreadUuid": "<string>",
      "projectUuid": "<string>",
      "aiDeepResearchRunUuid": "<string>"
    }
  ],
  "status": "ok"
}

{
  "error": {
    "name": "<string>",
    "statusCode": 123,
    "data": "<unknown>",
    "message": "<string>"
  },
  "status": "error"
}

Path Parameters

projectUuid · string<uuid> · required

Stringified UUIDv4. See RFC 4112

Pattern: [0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}

Query Parameters

threadUuid · string<uuid> · required

Stringified UUIDv4. See RFC 4112

Pattern: [0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}

Response

200

application/json

Success

results · object[] · required

Show child attributes

status · enum<string> · required

Available options: ok