> ## Documentation Index > Fetch the complete documentation index at: https://print.app/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create an option set > Checks an option set and publishes it to Shopify products: their pages show it (once the store's theme has the Print Configurator block), and its prices apply at add-to-cart. It must be priced in the store's currency (409 `currency_mismatch`). A product already on another option set moves to this one. With `dryRun`, nothing is written and the answer (200) says what would change. The merchant can open and edit it in Print Options, under Products. ## OpenAPI ````yaml openapi.json POST /v2/option-sets openapi: 3.1.0 info: title: Print.App API version: 2.1.0 description: >- Server-to-server API for Print.App integrations: designs and their page content, folders, files, fonts, palettes, product assignments, projects and editor links. Authenticate every request with a secret key: `Authorization: Bearer sk_…`. Never call it from a browser. servers: - url: https://api.print.app description: Production security: - bearerAuth: [] tags: - name: Account description: The account a secret key belongs to. - name: Designs description: >- The designs (templates) your customers start from: create them at a size, manage their pages, and place text, images and shapes on them. - name: Design folders description: >- Folders that organise your designs. A design can sit in more than one folder. - name: Files description: >- Your own images and graphics, used in designs and offered to customers in the editor. - name: Graphic folders description: >- Folders of files, shown in the editor under Pictures, Backgrounds, Textures or Frames. - name: Fonts description: >- The fonts your designs and customers can use: the built-in set, imported Google fonts and fonts you upload. - name: Palettes description: Colour palettes offered in the editor. - name: Products description: Which designs open for each product (and variant) in your store. - name: Projects description: Your customers' saved designs. - name: Links description: >- Project URLs (the dashboard's Create new Project URL): shareable links that open a design or project in the editor at create.print.app, to share with customers or to test a design. - name: Connectors description: >- Links between the options on a store's product page and the editor: the choice a customer makes shows the right pages, opens the right design, or sets the size, orientation or colour. Read a product page for what a connector can point at, and test one against a design before customers meet it. - name: Print Options description: >- Print Options is Print.App's free product options app (options.print.app): the sizes, papers, quantities and prices customers choose on a product page, priced on our servers when they add to cart. An option set is those questions and their prices; Print.App designs fill its artwork step, and connectors read its answers. Option sets are managed here for Shopify stores with both apps installed; templates and quotes work for any account. - name: Resource profiles description: >- Limits on the fonts, colour palettes and graphic folders the editor offers, for the designs that use them. - name: PDF profiles description: >- The settings print PDFs are made with: colour conversion, PDF standard, cut lines, image resolution, fonts. - name: 3D scenes description: >- The 3D scenes the editor previews designs on: models with print areas, folds, flipbooks and sheets, yours and the Print.App library's. A design picks one with `sceneId`. - name: Library description: >- The Print.App library, the store catalogue the dashboard's Import Designs and Import from Library open: ready-made designs, and themed kits of graphics. Find what suits a product, then bring it into your account: a design as your own copy, a kit as a folder that follows it, single graphics into a folder. - name: Settings description: >- The account's editor and product page settings: how the editor opens and behaves, and the selectors Print.App uses on your product pages. Settings that run code in your store, send data elsewhere or delete projects are kept to the dashboard. paths: /v2/option-sets: post: tags: - Print Options summary: Create an option set description: >- Checks an option set and publishes it to Shopify products: their pages show it (once the store's theme has the Print Configurator block), and its prices apply at add-to-cart. It must be priced in the store's currency (409 `currency_mismatch`). A product already on another option set moves to this one. With `dryRun`, nothing is written and the answer (200) says what would change. The merchant can open and edit it in Print Options, under Products. operationId: createOptionSet parameters: - $ref: '#/components/parameters/IdempotencyKey' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/OptionSetCreate' responses: '201': description: Created. headers: x-request-id: $ref: '#/components/headers/RequestId' idempotent-replayed: $ref: '#/components/headers/IdempotentReplayed' content: application/json: schema: $ref: '#/components/schemas/OptionSetChange' example: object: option_set_change dryRun: false optionSetId: 2f7c9e1a-4b8d-4e2f-9a61-0c3d5b7e8f10 title: Flyers currency: USD created: true deleted: false changes: - productId: '8123456789' title: Flyers change: added fromOptionSetId: null ok: true error: null failed: 0 fields: - id: size label: Size type: select-one role: size source: role: size reference: po:role/size sends: choice id as value, label as text choices: - value: a5 label: A5 selected: true - value: a4 label: A4 selected: false warnings: [] '400': description: >- A parameter or body field is malformed: `param` names it and `details` lists every problem found. headers: x-request-id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: true code: invalid_request message: width is required. param: width requestId: FZn-uhymjoEEJow= '401': description: Missing, unknown, revoked or expired secret key. headers: x-request-id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: true code: unauthorized message: >- Missing or invalid secret key. Send it as "Authorization: Bearer sk_…". requestId: FZn-uhymjoEEJow= '403': description: The account is suspended for an unpaid invoice. headers: x-request-id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: true code: account_suspended message: >- This account is suspended. Settle the outstanding invoice in the Print.App dashboard. requestId: FZn-uhymjoEEJow= '409': description: >- The request conflicts with the current state; `code` says how (`folder_not_empty`, `builtin_folder`, `builtin_palette`, `editor_not_supported`, `design_changed`, `idempotency_key_reused`, `idempotency_in_progress`, `print_options_unavailable`, `print_options_not_installed`, `currency_mismatch`). headers: x-request-id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: true code: folder_not_empty message: >- The folder still holds designs. Remove them from it (or delete them) first. requestId: FZn-uhymjoEEJow= '413': description: A body or a downloaded file is over its size limit. headers: x-request-id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: true code: payload_too_large message: The file at url is larger than 50 MB. param: url requestId: FZn-uhymjoEEJow= '415': description: The body is not JSON. headers: x-request-id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: true code: unsupported_media_type message: >- Send the request body as JSON, with "Content-Type: application/json". requestId: FZn-uhymjoEEJow= '429': description: >- Rate limited by the API gateway. Back off and retry. This response comes from the gateway, so its body is `{ "message": "Too Many Requests" }`, not the standard error. content: application/json: schema: $ref: '#/components/schemas/GatewayError' example: message: Too Many Requests '500': description: >- Something failed on our side. Retry; quote the requestId to support if it persists. headers: x-request-id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: true code: internal_error message: >- Something went wrong on our side. Retry the request; if it keeps failing, contact support with the requestId. requestId: FZn-uhymjoEEJow= '503': description: >- A service the request needs (such as library search) is busy or unavailable for a moment. Retry in a few seconds. headers: x-request-id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: true code: service_unavailable message: >- Searching the library is unavailable right now. Try again in a minute. requestId: FZn-uhymjoEEJow= components: parameters: IdempotencyKey: name: Idempotency-Key in: header required: false schema: type: string minLength: 1 maxLength: 255 description: >- Makes a retry safe: a second request with the same key and the same body gets the first response back (for 24 hours) instead of creating the resource again. Use a new key, such as a UUID, for every new request. schemas: OptionSetCreate: title: OptionSetCreate description: An option set and the Shopify products to publish it to. type: object additionalProperties: false required: - config - productIds properties: title: type: string minLength: 1 maxLength: 200 description: 'Its name in Print Options. Default: the config''s title.' config: type: object description: >- The option set itself: Print Options' JSON (version "2.0"), as in the [option set JSON reference](https://print.app/docs/print-options/developers/option-set-json). productIds: type: array minItems: 1 maxItems: 50 uniqueItems: true description: Shopify product ids (from `GET /v2/store-products`), up to 50. items: type: string pattern: ^(gid://shopify/Product/)?[0-9]{1,20}$ dryRun: type: boolean description: Check everything and say what would change, writing nothing. OptionSetChange: title: OptionSetChange description: >- What a create, update or delete did to each product, or would do (`dryRun`). type: object required: - object - dryRun - optionSetId - title - currency - created - deleted - changes - failed - fields - warnings properties: object: type: string const: option_set_change dryRun: type: boolean description: true when nothing was written. optionSetId: type: - string - 'null' description: The option set. null for a dry-run create. title: type: - string - 'null' currency: type: - string - 'null' created: type: boolean deleted: type: boolean changes: type: array items: type: object required: - productId - title - change - fromOptionSetId - ok - error properties: productId: type: string title: type: - string - 'null' change: type: string enum: - added - updated - moved - removed description: '`moved`: it was on another option set (`fromOptionSetId`).' fromOptionSetId: type: - string - 'null' ok: type: - boolean - 'null' description: Whether this product changed. null on a dry run. error: type: - string - 'null' description: >- Why it did not. The other products still changed: retry this one. failed: type: integer minimum: 0 description: Products that did not change. fields: type: array items: $ref: '#/components/schemas/PrintOptionsField' description: >- Its fields as connectors address them: give a field's `source` as a connector's `source`. warnings: type: array description: Things that will not stop it working but may not be meant. items: type: object required: - path - code - message properties: path: type: string code: type: string message: type: string examples: - object: option_set_change dryRun: false optionSetId: 2f7c9e1a-4b8d-4e2f-9a61-0c3d5b7e8f10 title: Flyers currency: USD created: true deleted: false changes: - productId: '8123456789' title: Flyers change: added fromOptionSetId: null ok: true error: null failed: 0 fields: - id: size label: Size type: select-one role: size source: role: size reference: po:role/size sends: choice id as value, label as text choices: - value: a5 label: A5 selected: true - value: a4 label: A4 selected: false warnings: [] Error: title: Error description: >- Every error the API itself returns. Match on `code`; `message` is for people and may be reworded. type: object required: - error - code - message - requestId properties: error: type: boolean const: true code: type: string enum: - unauthorized - account_suspended - invalid_request - not_found - route_not_found - idempotency_key_reused - idempotency_in_progress - folder_not_empty - builtin_folder - builtin_palette - editor_not_supported - design_changed - payload_too_large - unsupported_media_type - ops_failed - internal_error - service_unavailable description: >- `unauthorized` (401): missing, unknown, revoked or expired secret key. `account_suspended` (403): the account has an unpaid invoice. `invalid_request` (400): a parameter or body field is malformed — see `param` and `details`. `not_found` (404): no such resource in your account. `route_not_found` (404): no such endpoint. `idempotency_key_reused` (409): the Idempotency-Key was used for a different request. `idempotency_in_progress` (409): the first request with that key is still running. `folder_not_empty` (409): the folder still holds designs or folders. `builtin_folder`, `builtin_palette` (409): Print.App's own folders and palettes cannot be changed. `editor_not_supported` (409): page content can only be edited on accounts that use the new editor. `design_changed` (409): the design was saved elsewhere while the batch ran; read it again and retry. `payload_too_large` (413): a body or file over the limit. `unsupported_media_type` (415): send JSON. `ops_failed` (422): an operation in the batch failed, nothing was saved — see `details`. `internal_error` (500): retry; contact support with the `requestId` if it persists. `service_unavailable` (503): retry in a few seconds. message: type: string param: type: string description: The parameter or body field at fault, as a path (`pages[0].title`). details: type: array description: >- Every problem found, when there was more than one (`invalid_request`), or each operation's result (`ops_failed`). items: type: object requestId: type: string description: >- Also sent as the `x-request-id` header. Quote it when contacting support. examples: - error: true code: invalid_request message: limit must be an integer from 1 to 100. param: limit requestId: FZn-uhymjoEEJow= GatewayError: type: object properties: message: type: string description: Returned by the API gateway itself (429). PrintOptionsField: title: PrintOptionsField description: >- A Print Options field, as a connector points at it: by role when it has one, else by its id. type: object required: - id - label - type - role - source - reference - sends - choices properties: id: type: string label: type: - string - 'null' type: type: - string - 'null' description: select-one, select-many, quantity, dimensions, number, text, file… role: type: - string - 'null' description: Its role, explicit or from its type (quantity, dimensions, file). source: type: object description: >- What to give as `source`: `{ role }` when it has one, else `{ field }`. properties: role: type: string field: type: string reference: type: string description: 'The stored query: `po:role/` or `po:field/`.' sends: type: string choices: type: array items: type: object required: - value - label - selected properties: value: type: string description: What the page sends for it. label: type: - string - 'null' description: What the customer sees. selected: type: boolean description: Selected when the page loads. headers: RequestId: description: Identifies the request. Quote it when contacting support. schema: type: string IdempotentReplayed: description: >- `true` when the response is the stored answer to an earlier request with the same Idempotency-Key. schema: type: string securitySchemes: bearerAuth: type: http scheme: bearer description: >- A secret key from Print.App admin → Domains → Secret keys, sent as `Authorization: Bearer sk_…`. Server-side only. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.