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>",
      "executionContextSnapshot": {
        "effectivePermissions": {
          "autoApproveSql": true,
          "canUseSelfImprovementTools": true,
          "canUseContentTools": true,
          "canUseDataTools": true,
          "canRunSql": true,
          "canManageAgent": true
        },
        "repository": {
          "availableSkillNames": [
            "<string>"
          ],
          "repoFsSupportsCodeSearch": true,
          "repoFsRoot": "<string>",
          "repoDiscoveryEnabled": true,
          "previewDeploySetupEnabled": true,
          "codingAgentEnabled": true,
          "aiWritebackEnabled": true,
          "projectContextEnabled": true
        },
        "knowledgeDocuments": [
          {
            "alwaysIncludeInContext": true,
            "updatedAt": "<string>",
            "name": "<string>",
            "uuid": "<string>"
          }
        ],
        "tools": {
          "selectedMcpServers": [
            {
              "enabledToolNames": [
                "<string>"
              ],
              "name": "<string>",
              "uuid": "<string>"
            }
          ],
          "availableToolNames": [
            "<string>"
          ]
        },
        "model": {
          "reasoningEnabled": true,
          "modelName": "<string>",
          "provider": "<string>"
        },
        "agent": {
          "enableUserContext": true,
          "enableContentTools": true,
          "enableSelfImprovement": true,
          "enableDataAccess": true,
          "spaceAccess": [
            "<string>"
          ],
          "tags": [
            "<string>"
          ],
          "hasInstruction": true,
          "updatedAt": "<string>",
          "version": 123,
          "name": "<string>",
          "uuid": "<string>"
        },
        "capturedAt": "<string>",
        "schemaVersion": 1
      },
      "budget": {
        "maxHypotheses": 123,
        "maxResultRows": 123,
        "maxWarehouseQueries": 123,
        "maxToolCalls": 123
      },
      "isReportExpired": true,
      "reportExpiredAt": "<string>",
      "reportExpiresAt": "<string>",
      "resultChartData": {},
      "resultMarkdown": "<string>",
      "prompt": "<string>",
      "mcpServerUuids": [
        "<string>"
      ],
      "promptUuid": "<string>",
      "aiThreadUuid": "<string>",
      "agentUuid": "<string>",
      "projectUuid": "<string>",
      "aiDeepResearchRunUuid": "<string>"
    }
  ],
  "status": "ok"
}

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