Agent Job Status - Roe Documentation

curl --request GET \
  --url "https://api.roe-ai.com/v1/agents/jobs/YOUR_JOB_ID/status/" \
  --header "Authorization: Bearer YOUR_API_KEY"

{
  "status": 3,
  "timestamp": 1719556664.569293
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

GET

agents

jobs

{job_id}

status

curl --request GET \
  --url "https://api.roe-ai.com/v1/agents/jobs/YOUR_JOB_ID/status/" \
  --header "Authorization: Bearer YOUR_API_KEY"

{
  "status": 3,
  "timestamp": 1719556664.569293
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

curl --request GET \
  --url "https://api.roe-ai.com/v1/agents/jobs/YOUR_JOB_ID/status/" \
  --header "Authorization: Bearer YOUR_API_KEY"

Authorization

string

header

required

Organization API key passed as a Bearer token. This is the scheme used by the public SDK surface.

job_id

string<uuid>

required

organization_id

string<uuid>

Organization ID. This is required for access control. It can be provided via query or request body depending on the endpoint.

Agent job status

status

integer

required

Status code. 0: PENDING, 1: STARTED, 2: RETRY, 3: SUCCESS, 4: FAILURE, 5: CANCELLED, 6: CACHED

timestamp

number<double>

required

Unix timestamp in seconds (fractional)

error_message

string

Error message if status is RETRY or FAILURE