# Jobs

Section: Production. Part of the [API reference](https://developer.yoprint.com/reference.md). Web page: https://developer.yoprint.com/reference/jobs/

This page and all 23 operation pages, in 5 files: https://developer.yoprint.com/llms/jobs.txt (operations 1 to 4), https://developer.yoprint.com/llms/jobs-2.txt (operations 5 to 7), https://developer.yoprint.com/llms/jobs-3.txt (operations 8 to 10), https://developer.yoprint.com/llms/jobs-4.txt (operations 11 to 14), https://developer.yoprint.com/llms/jobs-5.txt (operations 15 to 23)

A job groups line items on a sales order or quote that are produced together, with their services (decorations), mockups, production files, tasks, dates and a status. The status is the job's production stage: read it from `status_id` on the job, and move it with Change a job's status.

## Operations (21)

- [Add a job to a sales order or quote](https://developer.yoprint.com/reference/jobs/v2-job-store.md): `POST /v2/api/store/{team_slug}/v2/sales_order/{hash_id}/job`. Adds a job to a sales order or quote.
- [Add a job from a job template](https://developer.yoprint.com/reference/jobs/v2-job-create-with-template.md): `POST /v2/api/store/{team_slug}/v2/sales_order/{hash_id}/job_template`. Adds a job to a sales order or quote from one of the team's job templates (job presets).
- [List the jobs of a sales order or quote](https://developer.yoprint.com/reference/jobs/v2-job-index-for-order.md): `GET /v2/api/store/{team_slug}/v2/sales_order/{hash_id}/job`. Returns the jobs of a sales order or quote, in the order's job order (`position`, as Rearrange sets it): their production status, dates, decoration services, work pipelines and mockups.
- [List jobs](https://developer.yoprint.com/reference/jobs/v1-job-index.md): `GET /v1/api/store/{team_slug}/job`. Returns one page of your team's jobs, across all sales orders.
- [List jobs in a date range](https://developer.yoprint.com/reference/jobs/v1-job-calendar.md): `POST /v1/api/store/{team_slug}/job/calendar`. Jobs whose start or due date falls in the range, or whose dates span it.
- [Filter jobs](https://developer.yoprint.com/reference/jobs/v1-job-filter.md): `POST /v1/api/store/{team_slug}/job/filter`. Returns one page of your team's jobs that match the filters, in the order you ask for.
- [Get one job of an order](https://developer.yoprint.com/reference/jobs/v2-job-show.md): `GET /v2/api/store/{team_slug}/v2/sales_order/{hash_id}/job/{job_id}`. Returns one job of a sales order or quote, with its mockups.
- [Update a job](https://developer.yoprint.com/reference/jobs/v2-job-update.md): `PUT /v2/api/store/{team_slug}/v2/job/{hash_id}`. Check `success`, not only the HTTP status: when the job's order is neither a draft nor published, this call answers HTTP 200 with…
- [Copy a job](https://developer.yoprint.com/reference/jobs/v2-job-clone.md): `PUT /v2/api/store/{team_slug}/v2/job/{hash_id}/clone`. Copies a job into a sales order or quote: the same one or another of your team's.
- [Change a job number](https://developer.yoprint.com/reference/jobs/v2-job-update-scoped-id.md): `PUT /v2/api/store/{team_slug}/v2/job/{hash_id}/scoped_id`. Sets the job number (`scoped_id`, shown as `JOB-<number>`).
- [Change a job's status](https://developer.yoprint.com/reference/jobs/v2-job-change-status.md): `PUT /v2/api/store/{team_slug}/v2/job/{hash_id}/status`. Check `success`, not only the HTTP status: when the job's order isn't published (a draft), this call answers HTTP 200 with…
- [Schedule a job](https://developer.yoprint.com/reference/jobs/v2-job-update-prod-date.md): `PUT /v2/api/store/{team_slug}/v2/job/{hash_id}/update_prod_date`. Sets, moves or clears a job's production start and due dates.
- [Reorder the jobs of a sales order or quote](https://developer.yoprint.com/reference/jobs/v2-job-rearrange.md): `PUT /v2/api/store/{team_slug}/v2/sales_order/{hash_id}/job/rearrange`. Puts the order's jobs in a new order.
- [Attach uploaded files to a job](https://developer.yoprint.com/reference/jobs/v1-sales-order-job-attach.md): `PUT /v1/api/store/{team_slug}/sales_order/{hash_id}/job/{id}/attach`. Attaches files you uploaded first to a job, as mockups or production files.
- [Reorder the files of a job](https://developer.yoprint.com/reference/jobs/v1-sales-order-job-rearrange.md): `PUT /v1/api/store/{team_slug}/sales_order/{hash_id}/job/{id}/rearrange`. Sets new positions for a job's mockups and production files.
- [Delete a job](https://developer.yoprint.com/reference/jobs/v2-job-destroy.md): `DELETE /v2/api/store/{team_slug}/v2/job/{hash_id}`. Check `success`, not only the HTTP status: when the job's order is neither a draft nor published, this call deletes the job anyway and then answers HTTP 200 with…
- [Download small job labels (PDF)](https://developer.yoprint.com/reference/jobs/v1-job-export-dymo-label.md): `POST /v1/api/store/{team_slug}/job/export_dymo_label`. Returns one PDF of small job labels sized 1" x 2-1/8" (Dymo), one label per job.
- [Download job details (PDF)](https://developer.yoprint.com/reference/jobs/v1-job-export-job-detail.md): `POST /v1/api/store/{team_slug}/job/export_job_detail`. Returns one PDF with the details of each job (work order style), without mockup images.
- [Download job details with mockups (PDF)](https://developer.yoprint.com/reference/jobs/v1-job-export-job-detail-mockup.md): `POST /v1/api/store/{team_slug}/job/export_job_detail_mockup`. Returns one PDF with the details of each job, including its mockups.
- [Download job labels (PDF)](https://developer.yoprint.com/reference/jobs/v1-job-export-job-label.md): `POST /v1/api/store/{team_slug}/job/export_job_label`. Returns one PDF of 4" x 6" job labels, one per job.
- [Download a job list (PDF)](https://developer.yoprint.com/reference/jobs/v1-job-export-job-list.md): `POST /v1/api/store/{team_slug}/job/export_job_list`. Returns one PDF that lists the jobs in a table, stamped with the time it was made.

## Legacy and internal operations (2)

Prefer the operations above. Legacy ones name their replacement; internal ones are built for YoPrint's own apps.

- [Get a job (retired)](https://developer.yoprint.com/reference/jobs/v1-job-show.md): `GET /v1/api/store/{team_slug}/job/{hash_id}` (legacy, deprecated). Retired.
- [Change a job's status (retired)](https://developer.yoprint.com/reference/jobs/v1-job-change-status.md): `PUT /v1/api/store/{team_slug}/job/{hash_id}/status` (legacy, deprecated). Retired.
