Handbook
Examples — Jobs lifecycle
Tutorial-grade narrative lives in Learn 101 — First job.
Updated
Canonical docker_argv payload (schema-checked): payloads/valid/job-create-request.json.
Language shortcuts:
| Language | Example |
|---|---|
curl |
curl.md + Examples & recipes |
| Python | python.md |
| TypeScript | typescript-fetch.md |
Contract tables: HTTP API · job-create-request.schema.json.
Purpose
Route readers to canonical docker_argv payloads and language-specific job examples.
Prerequisites
Running Fleet and the env conventions from curl.md (or linked language pages).
Copy-paste steps
Use First job for a full walkthrough; this page links out rather than duplicating blocks.
Expected output
POST /v1/jobs returns 201 with id, status, and ok: true (see OpenAPI createJob).
Error handling
See error-handling.md and job polling patterns in Learn 101.
Security notes
Send Authorization: Bearer … when the listen address is not loopback-only or when FLEET_ENFORCE_BEARER applies.
Related
Validation status
payloads/valid/job-create-request.jsonis validated againstjob-create-request.schema.jsonin CI (scripts/check-schema-examples.py).../schemas/openapi.jsonincludesoperationIdcreateJobandgetJobresponse schemas.