Felo API PlatformFelo API Platform

Data 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.