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.
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 POST 'https://api.snoze.dev/v1/workspaces/string/agent/jobs/string/pause'{ "data": { "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" }}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.
Resume a paused background AI job
Lets a paused job take parts again. A job that paused on its spend ceiling resumes only with a higher `ceilingMicrousd`; one that paused on the AI allowance resumes once there is allowance left. Requires a Clerk session for the job's owner with the `ai:write` permission. Send an `Idempotency-Key` header to make retries safe.