Tasks
Create a task
Create a long-running, multi-step research task that explores the web, gathers sources, synthesizes findings, and returns structured JSON results with citations.
Submit your request to POST /research/v0/tasks
with natural-language instructions
and an output.schema
describing the JSON you want back. If you do not provide an output schema, by default a detailed markdown report will be produced. The API responds immediately with a unique task id
that you can use to poll the task or list tasks.
Output Schema Requirements:
- Must be a valid JSON Schema
- Root type must be an
object
- All root-level fields must be in the
required
array - Must include
"additionalProperties": false
at the root level
POST
Get your Exa API key
Body
application/json
Response
201 - application/json
Research task created
The response is of type object
.