curl --request POST \
--url https://api.octen.ai/v1/agent \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"messages": [
{
"role": "user",
"content": "Who won the 2026 Nobel Prize in Physiology or Medicine?"
}
],
"tier": "low",
"stream": true
}
'{
"request_id": "20261016092031207H5RC2LJ9ZB",
"task_id": "agent-2b8e6d41c9a04f7e93d5a1c0e6b7f284",
"tier": "low",
"status": "queued",
"created_at": 1793608547
}Search Agent API Reference
Runs a Search Agent task that answers a question with cited sources, as a Markdown answer or as JSON that matches your schema.
curl --request POST \
--url https://api.octen.ai/v1/agent \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"messages": [
{
"role": "user",
"content": "Who won the 2026 Nobel Prize in Physiology or Medicine?"
}
],
"tier": "low",
"stream": true
}
'{
"request_id": "20261016092031207H5RC2LJ9ZB",
"task_id": "agent-2b8e6d41c9a04f7e93d5a1c0e6b7f284",
"tier": "low",
"status": "queued",
"created_at": 1793608547
}Authorizations
Bearer token used for request authentication. Alternatively, you can send the API key in the x-api-key header. Note: A payment method is required to use the API.
Body
Request body for the Search Agent API.
A list of messages comprising the conversation so far. User and assistant messages in chronological order for multi-turn conversations.
Show child attributes
Show child attributes
The task_id of a previous task, to continue its conversation.
The task tier. low, medium, and high increase search depth, cost, and time in that order. auto is billed by actual usage.
auto, low, medium, high Controls the output format.
Show child attributes
Show child attributes
Whether to enable streaming output. When true, returns chunks incrementally with types: status, step, content, finish, and usage.
Response
Successful Search Agent response. When stream=false, the task starts in queued. When stream=true, returns a stream of chunks.
- Option 1
- Option 2
A non-streaming Search Agent response. Returned when stream=false.
Unique identifier for the request.
Unique task id, used to retrieve the result.
The tier from the request.
auto, low, medium, high Task state.
queued Unix timestamp in seconds when the task was created.
Was this page helpful?