On this page

A job: state, and its result once finished

GET/jobs/{jobId}

Operation getJobAuthBearer token

Path parameters

NameTypeDescription
jobIdrequiredstring

Job id

Responses

StatusDescriptionBody
200The jobJob
idrequiredstring
kindrequiredstring

What the job does, e.g. mcp.registration-test

staterequiredstring

One of running, succeeded, failed, cancelled

createdAtrequirednumber

Epoch ms

finishedAtnumber
resultany

The work's answer (state succeeded): the route's documented result shape

errorstring

Why it failed or was cancelled

progressstring

The latest progress line the work reported

progressLogarray<JobProgressEntry>

The last 50 progress lines, oldest first

3 fields of progressLog
seqrequiredinteger

Numbered from 1 per job

textrequiredstring
detailobject

What the line is about, e.g. { "package": "@scope/name" } for an install

Errors 401 · 403 · 404
401Missing or wrong bearer token (unauthorized)
403The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin
404Unknown agent (or the named resource: loop, task, file, …)

Error bodies use the error format.

Example

Request
curl "http://127.0.0.1:7385/jobs/JOB_ID" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Cancel a running job

POST/jobs/{jobId}/cancel

Operation cancelJobAuthBearer token

Aborts the work at its next step and marks the job cancelled at once. Work that cannot stop mid-way (a download) finishes in the background; the job still reads cancelled.

Path parameters

NameTypeDescription
jobIdrequiredstring

Job id

Responses

StatusDescriptionBody
200Cancelled, or already finishedJobCancelResponse
cancelledrequiredboolean

False when the job had already finished

jobobject

Fields as in Job above.

Errors 401 · 403 · 404
401Missing or wrong bearer token (unauthorized)
403The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin
404Unknown agent (or the named resource: loop, task, file, …)

Error bodies use the error format.

Example

Request
curl -X POST "http://127.0.0.1:7385/jobs/JOB_ID/cancel" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"