Read a job
Reads a job. Needs no scope for the credential that created it. jobs:read reads the jobs of other credentials. Prefer: wait=N holds the request until the job ends, needs input, or the wait ends. Accept: text/event-stream streams the job. A credential with no access gets 404 job_not_found.
Authentication
An API key (crk_), an exchanged token (crt_) or a JWT of a trusted issuer. The credential needs the scope of the capability. Read the description of each route.
Path parameters
The job id: job_ and a ULID.
Headers
wait=N (1 to 90) holds the request up to N seconds. respond-async answers 202 at once. Behind a proxy with a 60 second idle timeout, use wait=55 or less.
Resumes a stream after the event with this seq.
Query parameters
The alias of Prefer: wait=N. The Prefer header wins when both are there.
Response headers
The id of the request: req_ and a ULID. Every answer has it.
Response
job_ and a ULID.
Only asap at this time.
Machine jobs only. What the job waits for while its status is needs_input, else null. The other jobs do not have this field.