List durable background jobs
LogsGET /jobs
Pages the background jobs that belong to the caller's tenant, with limit (default 20, max 100) and the after cursor. Each job shows its kind, status, attempts, last error and timestamps; payloads are never returned. When background jobs are not enabled on the installation, the list is empty. Needs the business:jobs:read scope.
Parameters
limitMaximum resources to return (default 20, maximum 100).
afterOpaque cursor returned by the previous page.
statusOnly jobs in this status: queued, running or succeeded (jobs that ran out of attempts are listed under the dead-letters endpoint instead).
one of
queued,running,succeededkindOnly jobs of this job kind, matched exactly.
Returns
200 Jobs
Show attributes
dataShow child attributes
idtenant_idkindstatusone of
queued,running,succeededattemptsmax_attemptslocked_bylast_errorrequest_idavailable_atcreated_atstarted_atfinished_at
has_morenext_cursor
Errors 403
Permissions business:jobs:read · Roles: admin, owner
curl -X GET "$BUSINESS_API/jobs" \
-H "Authorization: Bearer sk_test_..."
# No matching CLI command; use cURL or direct HTTP.
const res = await fetch("$BUSINESS_API/jobs", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$BUSINESS_API/jobs",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$BUSINESS_API/jobs", nil)
req.Header.Set("Authorization", "Bearer sk_test_...")
resp, err := http.DefaultClient.Do(req)
{
"data": [
{
"id": "job_2lTgcbHKkT9eq9du0vtmAFf4Mdb",
"tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
"kind": "active",
"status": "queued",
"attempts": 1,
"max_attempts": 1,
"locked_by": "locked by",
"last_error": "last error",
"request_id": "req_2JrY4JziCp1C0bFCSLb4M37qGNH",
"available_at": "2026-11-19T09:30:00Z",
"created_at": "2026-11-19T09:30:00Z",
"started_at": "2026-11-19T09:30:00Z",
"finished_at": "2026-11-19T09:30:00Z"
}
],
"has_more": true,
"next_cursor": "next cursor"
}