Listar trabalhos em segundo plano
RegistosGET /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.
Parâmetros
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).
um de
queued,running,succeededkindOnly jobs of this job kind, matched exactly.
Devolve
200 Jobs
Mostrar atributos
dataMostrar atributos filhos
idtenant_idkindstatusum de
queued,running,succeededattemptsmax_attemptslocked_bylast_errorrequest_idavailable_atcreated_atstarted_atfinished_at
has_morenext_cursor
Erros 403
Permissões business:jobs:read · Funções: admin, owner
curl -X GET "$BUSINESS_API/jobs" \
-H "Authorization: Bearer sk_test_..."
# Sem comando CLI equivalente; use cURL ou HTTP directo.
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"
}