Read a background AI job
One of the caller's jobs with its summary and up to fifty parts that failed for good, each with the reason in plain words. A job another member started reads as not found. Requires a Clerk session for a workspace member with the `ai:read` permission.
apiKeyAuthorizationBearer <snoze_sk_…>Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
workspaceId*stringjobId*stringSuccess
application/json- response
data*curl -X GET 'https://api.snoze.dev/v1/workspaces/string/agent/jobs/string'{ "data": { "job": { "id": "string", "workspaceId": "string", "chatId": "string", "kind": "records", "status": "queued", "statusReason": "person", "title": "string", "estimateMicrousd": 0, "ceilingMicrousd": 0, "spentMicrousd": 0, "waivedMicrousd": 0, "totalUnits": 0, "doneUnits": 0, "failedUnits": 0, "rowsWritten": 0, "summary": { "unitsDone": 0, "unitsFailed": 0, "unitsCancelled": 0, "rowsWritten": 0, "rowsSkipped": 0, "spentMicrousd": 0, "waivedMicrousd": 0, "durationMs": 0 }, "lastError": "string", "createdAt": "string", "updatedAt": "string", "startedAt": "string", "finishedAt": "string" }, "failedUnits": [ { "id": "string", "unitKey": "string", "ordinal": 0, "label": "string", "attempt": 0, "error": "string", "finishedAt": "string" } ] }}List your background AI jobs
The caller's own jobs in the workspace, newest first, with status, counters and spend. Another member's jobs are never listed. Pass `limit` (1–100) to cap the page. Requires a Clerk session for a workspace member with the `ai:read` permission.
Pause a background AI job
Stops the job from starting new parts; a part already running stops within a few seconds and goes back to the queue without being charged again. Only a queued or running job can be paused. Requires a Clerk session for the job's owner with the `ai:write` permission. Send an `Idempotency-Key` header to make retries safe.