Skip to main content
Deeptrace provides a REST API so you can trigger investigations and retrieve results from any system.

​
Quick Start

1

Create an API key

Go to Settings > API Keys in the Deeptrace dashboard and create a new key.
2

Trigger an investigation

Send a POST request to /api/v1/investigate with your query. You receive an investigation_id back immediately.
3

Poll for results

Poll GET /api/v1/investigations/{id} until status is completed. Investigations typically complete in a couple of minutes.
4

Use the results

Parse investigation_text for the full root cause analysis, or link to https://app.deeptrace.com/investigation/{id} for the web view with citations.

​
Endpoints

​
Investigations

Trigger Investigation

Start a new investigation asynchronously.

Get Investigation

Retrieve status and results of an investigation.

​
Chat

Send Chat Message

Send a message and get an AI-powered response.

Get Chat

Retrieve a chat with full conversation history.

List Chats

Get a paginated list of chats for your team.

​
Error Codes

Status CodeDescription
400Invalid request body or missing required fields
401Missing or invalid API key
403Expired or revoked API key
404Resource not found
422Validation error
500Internal server error