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.
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*stringapplication/json- body
ceilingMicrousd?number|nullSuccess
application/json- response
data*curl -X POST 'https://api.snoze.dev/v1/workspaces/string/agent/jobs/string/resume' \ -H 'Content-Type: application/json' \ -d '{}'{ "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" }}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.
Cancel a background AI job
Stops the job for good: queued parts are cancelled at once and running ones within a few seconds. Values already written stay. Requires a Clerk session for the job's owner with the `ai:write` permission. Send an `Idempotency-Key` header to make retries safe.