Start, pause, resume, and cancel a print job via OctoPrint's Job API
domain: docs.octoprint.org · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Authenticate requests with the X-Api-Key header (or a CSRF-protected session login) as required by all OctoPrint REST endpoints.
POST /api/job with {"command": "start"} to begin printing the currently selected file (requires the PRINT permission).
POST /api/job with {"command": "pause", "action": "pause"|"resume"|"toggle"} to control an active job.
POST /api/job with {"command": "cancel"} to abort, or {"command": "restart"} to restart a paused job from the beginning.
GET /api/job to retrieve job state, progress.completion, and file info.
Known gotchas
start/cancel/restart return 409 Conflict if the printer's current state doesn't meet the command's preconditions (e.g. start while already printing).
If the pause command's action parameter is omitted, the default behavior toggles pause/resume for backward compatibility, which can unexpectedly resume a print.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?