submit_job
Queue a 3D print job by specifying the G-code file, optional printer, and priority. Use an idempotency key to retry failed submissions without creating duplicate prints.
Instructions
Submit a print job to the queue.
Free tier allows up to 10 queued jobs for single-printer use.
Pro tier unlocks unlimited queue depth with multi-printer scheduling.
Args:
file_name: G-code file name (must already exist on the printer).
printer_name: Target printer name, or omit to let the scheduler
pick any idle printer.
priority: Higher values are scheduled first (default 0).
idempotency_key: Optional opaque key (e.g. a UUID you generate)
naming this one submission. If your call fails in a way
where you cannot tell whether the job was queued — a timeout,
a dropped connection — retry with the SAME key: you will get
the original job back (``submission: "replayed"``) instead of
queuing a duplicate print. Use a NEW key for each job you
genuinely want printed; reusing a key with different
parameters is refused.
Jobs are executed in priority order, with FIFO tie-breaking.
Use ``job_status`` to check progress and ``queue_summary`` for an overview.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| priority | No | ||
| file_name | Yes | ||
| printer_name | No | ||
| idempotency_key | No |