v4

latestOpenAPI 3.1.02026-08-07341215300.9 KB

Full Investigation Async

Start an investigation asynchronously and return immediately.

This is the correct pattern for long-running investigations behind an ALB/CDN:

  • Create a placeholder investigation row immediately
  • Spawn the investigation in the background
  • Caller polls GET /api/investigations/{id} (or MCP get_investigation) for results

Body format (FastAPI multi-body-params): { "request": {"query": "...", "system_message": "..."}, "mcps": ["sentry-mcp", ...] // optional — falls back to team DB config }

post/api/full_investigation_async

Query parameters

team_idstring nullable
anthropic_api_keystring nullable
custom_contextstring nullable
modelstring
enable_alt_hypothesesboolean
is_hypothesis_investigationboolean
enable_explore_subagentsboolean nullable
initiated_by_slack_user_idstring nullable
existing_investigation_idstring nullable

Request body

mcpsstring[] nullable

List of MCP server names to use for the investigation. If omitted, pulled from team config.

disabled_toolsstring[] nullable

Response

Successful Response

object required