v1

latestOpenAPI 3.0.02026-07-26100118773.0 KB

Create a deep research job

Starts a new deep research report generation. The job runs asynchronously and typically takes 5-10 minutes to complete. Use the returned job ID to poll for status and results via GET /v1/deep-research/:id. Consumes 500 credits. Enterprise teams receive 10 free report generations per month (shared with the Messari platform) which are consumed before credits. Optionally provide a job_id to send a follow-up message for iterative refinement of an existing report.

post/ai/v1/deep-research

Response

Default response

created_atinteger required

Unix timestamp when the job was created

job_idstring byte required

Unique identifier for the deep research job

modelstring required

Model used for the deep research

objectstring required

Type of object returned, always 'deep_research'

querystring required

The research query that was submitted for this job

statusstring required

Current status of the deep research job: queued, in_progress, completed, failed, cancelled