EXexa
Runs

Get a run

Changed on

Retrieves a single run by its ID, including the full output if the run is completed.

get/monitors/{id}/runs/{runId}

Request

  • Base URL
    https://api.exa.ai
  • URL
    https://api.exa.ai/monitors/{id}/runs/{runId}
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

Path parameters

idstring required

The monitor ID

runIdstring required

The run ID

Response

The run

idstring required

The unique identifier for the run

monitorIdstring required

The monitor this run belongs to

status'pending' | 'running' | 'completed' | 'failed' | 'cancelled' required

The status of the run

failReason'api_key_invalid' | 'insufficient_credits' | 'invalid_params' | 'rate_limited' | 'source_not_available' | 'forbidden' | 'search_unavailable' | 'search_failed' | 'internal_error' nullable required

The reason the run failed. Null unless status is failed. source_not_available means the search requested a domain Exa cannot return (remove it from the search), and forbidden means the request was otherwise not permitted.

startedAtstring date-time nullable required

When the run started executing

completedAtstring date-time nullable required

When the run completed successfully

failedAtstring date-time nullable required

When the run failed

cancelledAtstring date-time nullable required

When the run was cancelled

durationMsinteger nullable required

Total execution time in milliseconds

createdAtstring date-time required

When the run was created

updatedAtstring date-time required

When the run was last updated

Changes