数据 API / Exa / Agent
Poll a research Agent run.
Fetch an Agent run submitted by post_exa_agent_runs, by its jobId. Returns the same envelope — id, status, createdAt, completedAt, pricing, output, error. Repeat until status is completed, failed or cancelled; on success output carries text, structured and grounding. Reads a run only; it cannot start one.
参数
路径
jobIdstring必填The job id returned by the submit call.
请求示例
curl -X GET "https://openapi.felo.ai/v1/beta/exa/agent/runs/{jobId}" \
-H "Authorization: Bearer $FELO_API_KEY"响应
响应字段
idstring可选Job identifier. Use it with the corresponding Felo polling endpoint.
objectstring可选Always "integration_async_job".
endpointstring可选Provider operation identifier stored with the job. This metadata is not a Felo polling URL; use the documented Felo job path or Location header.
statusstring可选允许值： queued · running · completed · failed · cancelled
Customer-facing lifecycle status. queued and running are non-terminal; completed, failed, and cancelled are terminal.
createdAtstring可选When the job was accepted.
completedAt可选When the job reached a terminal status. Null while the job is still queued or running.
pricingobject可选currencystring可选authorizedMicrosUSDinteger可选Provider authorization metadata in micro-USD. This is not a Felo credit hold or billing record.
finalMicrosUSD可选Provider settlement metadata in micro-USD, nullable before settlement. This is not the Felo charge.
billingModestring可选Provider job billing mode. Felo charges follow Felo billing records.
output可选Job result payload. Present only once status is completed. For Agent Runs this is the structured research result.
outputExpiredboolean可选True when the result has been retained past its retention window and is no longer retrievable.
error可选Present when status is failed. Null otherwise.