Sign in

v1

latestOpenAPI 3.0.02026-07-1799139348.0 KB

Claim a job

Atomically claims a queued job for the job agent, transitioning it to in progress. Returns 409 if the job is no longer available to claim.

post/v1/workspaces/{workspaceId}/job-agents/{jobAgentId}/jobs/{jobId}/claim

Path parameters

workspaceIdstring required

ID of the workspace

jobAgentIdstring required

ID of the job agent

jobIdstring required

ID of the job

Response

Job claimed

completedAtstring date-time
createdAtstring date-time required
externalIdstring
idstring required
jobAgentConfigobject required
jobAgentIdstring required
metadataobject required
releaseIdstring required
startedAtstring date-time
status'cancelled' | 'skipped' | 'inProgress' | 'actionRequired' | 'pending' | 'failure' | 'invalidJobAgent' | 'invalidIntegration' | 'externalRunNotFound' | 'successful' | 'queued' required
updatedAtstring date-time required