Create a job preset

POST/v1/api/store/{team_slug}/setting/job_preset

v1Operation ID v1_public_job_preset_store

Saves a job preset, a ready-made job: a name, an optional note, the service lines (service), the tasks (pipeline), the people on the job (assigned_users) and files (mockup, production_file). It goes to the end of the list.

Each service line names a service, one of its options and where it goes on the product. Each task names the task preset it follows and who does it. Files are uploaded first with "Upload a file", then attached here by the upload's id; give a new service line a tmpid- id to link a file to it in the same request. Everything is checked against your team first; if anything doesn't match, nothing is saved.

Returns the new preset.

Permission

Needs the Manage Settings permission. The team owner always has it.

Business rules

Everything is checked against your team before anything is saved, and the whole save is one transaction: one refusal saves nothing.
A new line, task or person, and any reference you change, must be live: a service, saved location and task preset that aren't deleted, and people who are active members of your team. An update line that keeps a deleted service, location or task preset, or a person who has left, still saves.
A service option the service doesn't have still saves, but the preset reads is_valid: false.
Top-level assigned_users sets the people on the job itself: sent, it replaces them ([] removes everyone); left out, they stay. On a task update line, assigned_users works the same way; a task create line without it has nobody.
Files: a create row attaches a file you uploaded with "Upload a file" and not yet attached anywhere; a mockup must be an image. update and delete rows act only on this preset's own files; one that is already gone is skipped.

Side effects

Attaching an upload moves it onto the preset: it is no longer a free upload.
Team members who have YoPrint open see the new preset at once.

Path parameters

team_slugstringrequired
Your team slug, shown as Team ID next to your API key in Profile.
- Example your-team

Request body

application/json, required.

namestringrequired
assigned_usersarray of objects
The people on the job itself. Each must be an active member of your team.
Fields of each item (1)
- idstringrequired
  A team member's id, from GET /v1/api/store/{team_slug}/setting/user.
mockuparray of objects
Mockup images. A create row must be an image file.
Fields of each item (6)
- actionstringrequired
  Send create: it attaches a file you uploaded with "Upload a file" (POST /v1/api/store/{team_slug}/async_upload). A new preset has no files to update or delete yet.
  - One of: "create", "update", "delete"
- idstringrequired
  For create, the upload's id. For update and delete, the file's id from the preset's mockup list.
- job_servicestring | array
  The service line, or a list of them, this file belongs to: a line's id, or the tmpid- id of a line created in the same request. Ids that are not lines of this preset are ignored. When sent, it replaces the file's links; [] removes them.
- namestring
  The file's display name. Left out, it keeps its name.
- positioninteger
  For update: where the file sorts among the preset's mockups. A create row always goes last.
- show_in_pdfboolean
  Whether the mockup shows on PDFs. Jobs made from the preset keep the setting.
notestring | null
pipelinearray of objects
Fields of each item (6)
- actionstringrequired
  Required, but every task is created on a new preset whatever you send. Send create.
  - One of: "create", "update", "delete"
- assigned_usersarray of objects
  Who the task is assigned to; without it, nobody. Each must be an active member of your team.
  Fields of each item (1)
  - idstringrequired
    A team member's id, from GET /v1/api/store/{team_slug}/setting/user.
- namestring
  The task's name.
- notestring | null
- pipeline_idstring
  The task preset this task follows, from GET /v1/api/store/{team_slug}/setting/pipeline. Required unless action is delete. A new task, or one that changes it, needs a task preset that isn't deleted.
- positioninteger
  - Minimum -2147483648
  - Maximum 2147483647
production_filearray of objects
Production files, of any type.
Fields of each item (6)
- actionstringrequired
  Send create: it attaches a file you uploaded with "Upload a file" (POST /v1/api/store/{team_slug}/async_upload). A new preset has no files to update or delete yet.
  - One of: "create", "update", "delete"
- idstringrequired
  For create, the upload's id. For update and delete, the file's id from the preset's production_file list.
- job_servicestring | array
  The service line, or a list of them, this file belongs to: a line's id, or the tmpid- id of a line created in the same request. Ids that are not lines of this preset are ignored. When sent, it replaces the file's links; [] removes them.
- namestring
  The file's display name. Left out, it keeps its name.
- positioninteger
  For update: where the file sorts among the preset's production files. A create row always goes last.
- show_in_pdfboolean
  Saved on the file and copied to jobs made from the preset.
servicearray of objects
Fields of each item (8)
- actionstringrequired
  Required, but every line is created on a new preset whatever you send. Send create.
  - One of: "create", "update", "delete"
- customer_notestring | null
  A note the customer sees. Jobs made from the preset get it on their service.
- idstring
  Optional: a temporary id that starts with tmpid- (such as tmpid-1), so a file row in the same request can name this line in job_service.
- locationobject
  Where the service goes on the product. Required unless action is delete.
  Child fields (3)
  - typestringrequired
    database: one of your saved service locations, by id (from GET /v1/api/store/{team_slug}/service_location). custom: a one-off location, by name.
    One of: "database", "custom"
  - idstring
    Required when type is database. A new or changed location must not be deleted. Ignored for custom.
  - namestring
    Required when type is custom.
- notestring | null
  A production note for this service.
- optionstring
  One of the service's options (a column of its price table). Required unless action is delete. Any value saves, but one the service doesn't have marks the preset is_valid: false.
- positioninteger
  Order of the service lines. Required unless action is delete.
  - Minimum -2147483648
  - Maximum 2147483647
- service_idstring
  The decoration service ID. Required unless action is delete. The service must be active (not deleted). Services are not listed directly on the public API; copy service_id from an existing job preset (List job presets) or from a job's services.

Response

200Successful response.

dataobjectrequired
Child fields (12)
- assigned_usersarray of objectsrequired
  The people on the job itself. Jobs made from the preset get the ones still on your team.
  Fields of each item (4)
  - avatar_urlstring | nullrequired
    Their profile picture, or null.
  - idstringrequired
  - namestringrequired
  - removedbooleanrequired
    True when the person was deleted or is no longer on your team. They stay listed until someone takes them off; jobs made from the preset leave them out.
- idstringrequired
- is_validbooleanrequired
  False when a service, saved location, or task preset it uses was deleted, or a service option no longer exists.
- mockuparray of objectsrequired
  Mockup images, in their order.
  Fields of each item (19)
  - collectionstringrequired
    One of: "mockup", "production_file"
  - created_atstring (date-time)required
    When the file record was made: the upload time, or for a duplicated preset, when it was copied.
  - custom_propertiesobject | arrayrequired
  - file_namestringrequired
  - idstringrequired
    The file's id: use it in update and delete file rows.
  - is_imagebooleanrequired
  - job_preset_idstringrequired
    The preset the file belongs to.
  - job_servicearray of stringsrequired
    The ids of this preset's service lines the file belongs to. A job made from the preset links its copy to the matching new services.
  - mime_typestring | nullrequired
  - namestring | nullrequired
    The display name.
  - positioninteger | nullrequired
    Where the file sorts, lowest first.
  - previewobject | nullrequired
    Preview image links small, medium and large (250, 800 and 1200 px), or null when there is no preview.
  - show_in_pdfboolean | nullrequired
    Null when it was never set.
  - sizeintegerrequired
    Bytes.
  - source_media_idnullrequired
    Always null on a preset's files.
  - urlstring | nullrequired
    Where to download the file.
  - view_urlstring | nullrequired
    A signed link to view the file. It expires: read it fresh, and don't store it.
  - dimensionsobject | null
    Pixel size of an image, read from its header; null for other files and for images uploaded before the size was recorded.
    Child fields (2)
    heightinteger
    widthinteger
  - preview_statestring
    ready: the preview links work. processing: an image over 10 MB whose stored preview a worker is still making (seconds); read the file again, or in the web app wait for media.preview_state_changed on the team channel. too_large: an image over 120 megapixels; it never gets a preview. failed: the worker gave up. none: not an image.
    One of: "ready", "processing", "too_large", "failed", "none"
- namestringrequired
- needs_reviewbooleanrequired
  True when the preset needs review (shown as "Needs review" in the web app):
  - is_valid is false (a service, service option, saved location, or task preset was deleted)
  - A team member assigned to one of its tasks was deleted or left the team (assignees on the job itself do not trigger review)
  A preset that needs review still saves. Creating a job from it omits missing tasks and removed teammates.
- notestring | nullrequired
- pipelinearray of objectsrequired
  The tasks.
  Fields of each item (11)
  - assigned_usersarray of objects
    Same fields as data.assigned_users.
  - idstring
  - is_validboolean
  - namestring | null
  - notestring | null
  - pipelineobject | null
    The task preset it follows, as GET /v1/api/store/{team_slug}/setting/pipeline/{hash_id} returns it: id, label, color, version, enable, trashed, and its statuses (deleted ones included).
    Child fields (7)
    colorstring
    enableboolean
    idstring
    labelstring
    statusesarray of objects
    Fields of each item (9)
    colorstringrequired
    customer_labelstringrequired
    What customers see in the customer portal. When none is set: Pending for start, In Progress for in_progress and pre_production, Completed for end.
    idstringrequired
    labelstringrequired
    positionintegerrequired
    Sort order within the list, lowest first.
    rolestringrequired
    Which list the status belongs to:
    
    order: sales orders
    
    quote: quotes
    
    job: jobs
    
    purchase_order: purchase orders
    
    shipment: shipments
    
    customer_message: message threads
    
    pipeline: tasks within a task preset
    
    One of: "order", "quote", "job", "purchase_order", "shipment", "customer_message", "pipeline"
    trashedbooleanrequired
    True for a deleted status. Only the full list includes deleted ones.
    typestringrequired
    The stage of the status in the workflow: start (first status in the list), pre_production, in_progress, or end (final status).
    One of: "start", "pre_production", "in_progress", "end"
    pipeline_idstring
    The task preset, for pipeline statuses only. Absent for every other role.
    trashedboolean
    versioninteger
  - pipeline_colorstring | null
    The task preset's color.
  - pipeline_idstring
  - pipeline_namestring | null
    The task preset's name.
  - positioninteger
    0 when none was sent.
  - trashedboolean
    True when its task preset was deleted.
- positionstringrequired
  Sort order within the preset list, lowest first. A decimal string, such as "1.0000000000000000"; parse it as a decimal.
- production_filearray of objectsrequired
  Production files, in their order.
  - Same fields as data.mockup.
- servicearray of objectsrequired
  The service lines.
  Fields of each item (11)
  - versioninteger
    Always 1
  - customer_notestring | null
  - idstring
  - locationobject
    type, display_name and trashed (true when a saved location was deleted), plus id for a saved location or name for a custom one.
  - notestring | null
  - optionstring | null
  - positioninteger
  - review_reasonstring | null
    Why the line needs review: its service was deleted, the service no longer has this option, or its saved location was deleted. Null when the line is fine.
    One of: "service_removed", "option_removed", "location_removed"
  - service_idstring
  - service_namestring | null
  - validboolean
    False when review_reason is set.
- updated_atstring (date-time) | nullrequired
  When the preset was last edited ("Last edited" in the web app). Every save changes it, even one that changes only its lines; reordering presets doesn't.
statusintegerrequired
successbooleanrequired

Errors

401The API key is missing or wrong (unauthenticated).
403You are not allowed to do this. api_access_not_in_plan: your team's plan doesn't include API access (Pro and above, with an active subscription or trial), so every request answers this until the team upgrades. When your role lacks the permission the operation needs, the body is only {"message": "Insufficient Permission"}. Other refusals use the error envelope, with unauthorized or user_is_not_authorized.
When
Your role lacks Manage Settings. The body is {"message": "Insufficient Permission"}, without the error envelope.
Fix
Use the key of a member whose role has Manage Settings, or the owner's.
404Not found. page_not_found: the team slug is unknown, you are not a member of the team, or an id in the path is not one of this team's. code: null, with a message that starts "No query results for": there is no record with that id.
When
A create file row names no upload of your team, or an update or delete file row names a file that isn't this preset's. error.code is null.
Fix
Use the upload's id, or a file id from the preset.
422The request was refused and changed nothing. validation_failed lists what to fix in error.fields; other codes name a business rule, explained in error.message. A few checks answer with only {"message": "..."}. An operation that calls another service (a payment provider, a carrier, an accounting app) can answer connect_timeout ("Please retry again") when that service does not answer in time: the change may or may not have happened there, so read the record back before you retry.
When
name is missing (create), a line or file row has no action, a file row has no id, or a service line misses service_id, option, location.type or position (validation_failed).
Fix
Send every required field; see the schema.
When
A service, location, task preset or person is not your team's, or is deleted where a live one is needed; or a file row names a file that isn't a free upload, or a mockup that isn't an image. error.code job_validation_error, with a message such as "Service not found!", "Assigned User not found!", "Please upload this file before adding it to a job preset." or "Mockups must be image files."
Fix
Use ids from your own team's lists, and upload files first.

POSTUpload a file/v1/api/store/{team_slug}/async_upload
PATCHTouch a job preset/v1/api/store/{team_slug}/setting/job_preset/{hash_id}
POSTDuplicate a job preset/v1/api/store/{team_slug}/setting/job_preset/{hash_id}/duplicate
GETList task presets/v1/api/store/{team_slug}/setting/pipeline

Example request

curl

curl -X POST 'https://secure.yoprint.com/v1/api/store/your-team/setting/job_preset' \  -H 'Authorization: Bearer YOUR_API_KEY' \  -H 'Accept: application/json' \  -H 'X-Yoprint-Decimal-Format: exact-v1' \  -H 'Content-Type: application/json' \  -d '{    "mockup": [      {        "action": "create",        "id": "uAzgeGQMGvaVK3",        "job_service": "tmpid-1",        "name": "Front logo",        "show_in_pdf": true      }    ],    "name": "Front print, one color",    "note": "Standard tee front print",    "pipeline": [      {        "action": "create",        "assigned_users": [          {            "id": "E6LjYJJimQNFVF"          }        ],        "name": "Print",        "pipeline_id": "eIOQnV5PP0pp7c",        "position": 1      }    ],    "service": [      {        "action": "create",        "customer_note": "Printed on the front, centered",        "id": "tmpid-1",        "location": {          "id": "t1vO0qwTosoy1d",          "type": "database"        },        "option": "1 Color",        "position": 1,        "service_id": "sV7LFB1gpCcF8O"      }    ]  }'

Example response 200

{
  "data": {
    "assigned_users": [],
    "id": "8vxTyCrd1y1gdf",
    "is_valid": true,
    "mockup": [
      {
        "collection": "mockup",
        "created_at": "2026-11-03T09:00:00+00:00",
        "custom_properties": {
          "show_in_pdf": true
        },
        "file_name": "front-logo.png",
        "id": "uAzgeGQMGvaVK3",
        "is_image": true,
        "job_preset_id": "8vxTyCrd1y1gdf",
        "job_service": [
          "amcoNda0bOuIpO"
        ],
        "mime_type": "image/png",
        "name": "Front logo",
        "position": 1,
        "preview": {
          "large": "https://example.com/media/uAzgeGQMGvaVK3/preview-1200.png",
          "medium": "https://example.com/media/uAzgeGQMGvaVK3/preview-800.png",
          "small": "https://example.com/media/uAzgeGQMGvaVK3/preview-250.png"
        },
        "show_in_pdf": true,
        "size": 48211,
        "source_media_id": null,
        "url": "https://example.com/media/uAzgeGQMGvaVK3/download",
        "view_url": "https://example.com/media/uAzgeGQMGvaVK3/view"
      }
    ],
    "name": "Front print, one color",
    "needs_review": false,
    "note": "Standard tee front print",
    "pipeline": [
      {
        "assigned_users": [
          {
            "avatar_url": null,
            "id": "E6LjYJJimQNFVF",
            "name": "Alex Rivera",
            "removed": false
          }
        ],
        "id": "87uNbl9N8J0OPz",
        "is_valid": true,
        "name": "Print",
        "note": null,
        "pipeline": {
          "color": "#FFFFFF",
          "enable": true,
          "id": "eIOQnV5PP0pp7c",
          "label": "Screen printing",
          "statuses": [
            {
              "color": "#f5f5f5",
              "customer_label": "Pending",
              "id": "fA3KDzwnMRc5Cd",
              "label": "To do",
              "pipeline_id": "eIOQnV5PP0pp7c",
              "position": 0,
              "role": "pipeline",
              "trashed": false,
              "type": "start"
            },
            {
              "color": "#424242",
              "customer_label": "Completed",
              "id": "MIJM9QpP6O0whd",
              "label": "Done",
              "pipeline_id": "eIOQnV5PP0pp7c",
              "position": 1,
              "role": "pipeline",
              "trashed": false,
              "type": "end"
            }
          ],
          "trashed": false,
          "version": 1
        },
        "pipeline_color": "#FFFFFF",
        "pipeline_id": "eIOQnV5PP0pp7c",
        "pipeline_name": "Screen printing",
        "position": 1,
        "trashed": false
      }
    ],
    "position": "1.0000000000000000",
    "production_file": [],
    "service": [
      {
        "customer_note": "Printed on the front, centered",
        "id": "amcoNda0bOuIpO",
        "location": {
          "display_name": "Front",
          "id": "t1vO0qwTosoy1d",
          "trashed": false,
          "type": "database"
        },
        "note": null,
        "option": "1 Color",
        "position": 1,
        "review_reason": null,
        "service_id": "sV7LFB1gpCcF8O",
        "service_name": "Screen printing",
        "valid": true,
        "version": 1
      }
    ],
    "updated_at": "2026-11-03T09:00:00+00:00"
  },
  "status": 200,
  "success": true
}

AI agents: read /llms.txt; add .md to any page URL for its Markdown. Guides and concepts in one file: /llms-full.txt.

Download the OpenAPI spec Support: support@yoprint.com yoprint.com