Skip to main content
POST
/
api
/
v1
/
investigate
curl -X POST https://api.deeptrace.com/api/v1/investigate \
  -H "X-API-Key: dt_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"query": "Why are we seeing 500 errors on /checkout?"}'

{
  "investigation_id": "d2ce1b29-f36a-43f0-9a96-c73a167b59f8",
  "status": "processing"
}

Documentation Index

Fetch the complete documentation index at: https://docs.deeptrace.com/llms.txt

Use this file to discover all available pages before exploring further.

Start a new investigation. Returns an investigation_id immediately — the investigation runs in the background. Poll Get Investigation for results.

​
Headers

​
X-API-Key
string
required
Your Deeptrace API key. Obtain from Settings > API Keys. Also accepts Authorization: Bearer <key>.

​
Body

​
query
string
required
The investigation prompt. Describe the issue you want Deeptrace to investigate.
curl -X POST https://api.deeptrace.com/api/v1/investigate \
  -H "X-API-Key: dt_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"query": "Why are we seeing 500 errors on /checkout?"}'

​
Returns

Returns the newly created investigation with its ID and initial status. 
{
  "investigation_id": "d2ce1b29-f36a-43f0-9a96-c73a167b59f8",
  "status": "processing"
}
​
investigation_id
string
required
UUID of the created investigation. Use this to poll Get Investigation for results.
​
status
string
required
processing