curl https://api.deeptrace.com/api/v1/investigations/d2ce1b29-f36a-43f0-9a96-c73a167b59f8 \
-H "X-API-Key: dt_your_key_here"
import requests
response = requests.get(
"https://api.deeptrace.com/api/v1/investigations/d2ce1b29-f36a-43f0-9a96-c73a167b59f8",
headers={"X-API-Key": "dt_your_key_here"}
)
data = response.json()
print(data["status"], data["investigation_text"])
const response = await fetch(
"https://api.deeptrace.com/api/v1/investigations/d2ce1b29-f36a-43f0-9a96-c73a167b59f8",
{
headers: { "X-API-Key": "dt_your_key_here" },
}
);
const data = await response.json();
console.log(data.status, data.investigation_text);
{
"id": "d2ce1b29-f36a-43f0-9a96-c73a167b59f8",
"status": "processing",
"alert_summary": null,
"investigation_text": null
}
{
"id": "d2ce1b29-f36a-43f0-9a96-c73a167b59f8",
"status": "completed",
"alert_summary": "Spike in 500s caused by connection pool exhaustion",
"investigation_text": "**Quick Summary:** The 500 errors on /checkout are caused by..."
}
API
Get Investigation
Retrieve the status and results of a Deeptrace investigation
GET
/
api
/
v1
/
investigations
/
{investigation_id}
curl https://api.deeptrace.com/api/v1/investigations/d2ce1b29-f36a-43f0-9a96-c73a167b59f8 \
-H "X-API-Key: dt_your_key_here"
import requests
response = requests.get(
"https://api.deeptrace.com/api/v1/investigations/d2ce1b29-f36a-43f0-9a96-c73a167b59f8",
headers={"X-API-Key": "dt_your_key_here"}
)
data = response.json()
print(data["status"], data["investigation_text"])
const response = await fetch(
"https://api.deeptrace.com/api/v1/investigations/d2ce1b29-f36a-43f0-9a96-c73a167b59f8",
{
headers: { "X-API-Key": "dt_your_key_here" },
}
);
const data = await response.json();
console.log(data.status, data.investigation_text);
{
"id": "d2ce1b29-f36a-43f0-9a96-c73a167b59f8",
"status": "processing",
"alert_summary": null,
"investigation_text": null
}
{
"id": "d2ce1b29-f36a-43f0-9a96-c73a167b59f8",
"status": "completed",
"alert_summary": "Spike in 500s caused by connection pool exhaustion",
"investigation_text": "**Quick Summary:** The 500 errors on /checkout are caused by..."
}
Retrieve the current status and results of an investigation. Poll this endpoint until
status is completed. Investigations typically complete in a few minutes.
Headers
string
required
Parameters
string
required
UUID of the investigation, returned by Trigger Investigation.
curl https://api.deeptrace.com/api/v1/investigations/d2ce1b29-f36a-43f0-9a96-c73a167b59f8 \
-H "X-API-Key: dt_your_key_here"
import requests
response = requests.get(
"https://api.deeptrace.com/api/v1/investigations/d2ce1b29-f36a-43f0-9a96-c73a167b59f8",
headers={"X-API-Key": "dt_your_key_here"}
)
data = response.json()
print(data["status"], data["investigation_text"])
const response = await fetch(
"https://api.deeptrace.com/api/v1/investigations/d2ce1b29-f36a-43f0-9a96-c73a167b59f8",
{
headers: { "X-API-Key": "dt_your_key_here" },
}
);
const data = await response.json();
console.log(data.status, data.investigation_text);
Returns
Returns an investigation object. While the investigation is running,status is processing and result fields are null. Once finished, status is completed and the full analysis is available.
{
"id": "d2ce1b29-f36a-43f0-9a96-c73a167b59f8",
"status": "processing",
"alert_summary": null,
"investigation_text": null
}
{
"id": "d2ce1b29-f36a-43f0-9a96-c73a167b59f8",
"status": "completed",
"alert_summary": "Spike in 500s caused by connection pool exhaustion",
"investigation_text": "**Quick Summary:** The 500 errors on /checkout are caused by..."
}
string
UUID of the investigation.
string
processing while the investigation is running, completed when finished.string | null
Short title summarizing the investigation findings.
null while processing.string | null
Full investigation results in markdown format.
null while processing.Completed investigations are also viewable at
https://app.deeptrace.com/investigation/{id} with full citations and tool call details.