v1

latestOpenAPI 3.1.02026-07-26194149.1 KB
Research

Get Status And Results

Returns the current status (queued, running, succeeded, failed) and any results if completed.

get/v1/research/tasks/{task_id}

Path parameters

task_idstring required

Response

Successful Response

task_idstring required

Unique identifier for this research task

view_urlstring required

URL to view task progress and results

status'queued' | 'running' | 'succeeded' | 'failed' required

Current status of the research task

resultstring nullable

Research results in markdown format if completed

structured_output_status'not_requested' | 'pending' | 'succeeded' | 'failed' nullable

Whether structured output was requested, is still pending, succeeded, or failed

created_atstring date-time nullable

When the task was created

rejection_reason'insufficient_prepaid_balance' | 'budget_exceeded' | 'subscription_inactive'