Start Deep Research run

Start a durable Deep Research investigation.

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

Error

A valid request URL is required to generate request examples

202

{
  "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}

Body

application/json

prompt · string · required

promptUuid · string

Thread message that captured this prompt. Requires threadUuid.

threadUuid · string

Agent thread to attach the run to. Must be owned by the caller.

effort · enum<string>

Server-owned execution budget tier. Defaults to medium.

Available options: high, medium, low, xhigh

Response

202

application/json

Accepted

results · object · required

Show child attributes

status · enum<string> · required

Available options: ok