---
title: "Full Investigation"
method: POST
path: "/api/full_investigation"
---

# Full Investigation

`POST /api/full_investigation`

End-to-end investigation pipeline that processes a query and returns final analysis.

Args:
    existing_investigation_id: Optional pre-created investigation ID (placeholder) to update instead of creating new.
    enable_alt_hypotheses: Whether to generate alternative hypotheses (default True).
    is_hypothesis_investigation: If True, use "Hypothesis Result" instead of "Quick Summary" in prompts.
    alert_timestamp: Optional datetime to use for timestamp context instead of current time.
                    Used for backtesting to provide the original alert time context.

## Query parameters

- `team_id` string, nullable
- `slack_perma_link` string, nullable
- `message_ts` string, nullable
- `channel_id` string, nullable
- `anthropic_api_key` string, nullable
- `custom_context` string, nullable
- `skip_db_save` boolean
- `model` string
- `old_investigation_id` string, nullable
- `existing_investigation_id` string, nullable
- `enable_alt_hypotheses` boolean
- `is_hypothesis_investigation` boolean
- `alert_timestamp` string, date-time, nullable
- `enable_explore_subagents` boolean, nullable
- `initiated_by_slack_user_id` string, nullable
- `investigation_monitor_id` string, nullable
- `investigation_source` string

## Request body

- BodyFullInvestigationApiFullInvestigationPost
  - `request` FullInvestigationRequest, required — Request body for full investigation pipeline.
    - `query` string, required
    - `system_message` string, nullable
  - `mcps` string[], required
  - `disabled_tools` string[], nullable
  - `images` object[], nullable
  - `ci_history_tool_context` object, nullable

## Response `200`

Successful Response

- FullInvestigationResponse — Response from full investigation pipeline.
  - `final_answer` string, required
  - `assistant_response` string, required
  - `investigation_count` integer, required
  - `processing_summary` string, required
  - `investigation_id` string, nullable
  - `blocks` object[], nullable
  - `recommended_pr` object, nullable
  - `trigger_action_data` object[], nullable
  - `quick_summary_citations` object[], nullable
  - `data_sources` object[], nullable
  - `original_query` string, nullable
  - `alt_hypotheses` string[], nullable
  - `usage` object, nullable
  - `severity` integer, nullable
  - `suggest_ticket_called` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/deeptrace/apis/fastapi.md) · [All operations](https://skmtc.net/deeptrace/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deeptrace/fastapi/versions/2e2a6de8aeda/schema)