Customiser labels
Attach the labels product image
Takes the raster image of a staged upload and makes it the labels
document's product image — the picture shown beside the product title in
the summary — returning the labels with product_image_url pointing at
the new file. Requires customisers:write and an Idempotency-Key.
Overview
Create the upload first with POST/api/v3/uploads using purpose
label_image, send the bytes to the presigned target it returns, then
send that upload's id here. An upload whose purpose is not label_image
answers 422 upload_purpose_mismatch. The upload is single use:
attaching it a second time answers 409.
Only PNG, JPEG and WebP are accepted. SVG is refused when the upload is
created, because the label image path stores files as they arrive and
does not sanitise them.
The bytes are verified here, not at create: the object must exist, be
within the purpose's cap, start with the magic bytes of the type it was
declared as, and carry a readable image header. A file that fails leaves
the upload rejected with the failure's code, and attaching it again
replays that code — fix the file and create a new upload rather than
retrying.
The product image is the only file this document publishes a write for,
which is why this operation names it rather than taking a slot parameter.
background_images and additional_information carry files too and
remain read-only; when either gets a write it will get its own address.
Attaching over an image that is already there replaces it. The previous
file is deleted once the new one is committed, so any URL published for
it stops resolving.
The attach clears the customiser's cached storefront configuration and
runs the advisory language sync. It never regenerates Shopify products,
product images, or the product cache. A customiser that has never had its
labels edited gets its labels row here, exactly as its first label write
would create one.
Authorisation
Bearer token required. Include it in the Authorization header.
Required scope: customisers:write
Path parameters
The customiser id.
Example: 1
Request body
Request body example
{
"upload_id": "upl_9f2c4b7ad13e6058ba41cd4201"
}curl https://web.signcustomiser.com/api/v3/customisers/1/labels/product-image \
--request PUT \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"upload_id": "upl_9f2c4b7ad13e6058ba41cd4201"
}'{
"data": {
"object": "customiser_labels",
"customiser_id": 42,
"adding_to_cart": "Adding to Cart",
"allow_custom_background": true,
"apply_style": "Apply to all",
"aspect_ratio_warning": "Values may be modified to maintain the required aspect ratio",
"backboard_upload_error": "Maximum upload size 2mb",
"backgrounds": "Backgrounds",
"backlight_title": "Backlight",
"border_included": "(includes {border} border)",
"bottom_side": "Bottom",
"braille_fixed_size_info_label": "Braille dots stay at their accessibility-standard size; larger sign sizes carry larger tactile lettering.",
"braille_frame_too_small_message": "Choose a bigger sign size so the braille can fit at its fixed size.",
"braille_overview_fitted_to_screen_label": "Overview — fitted to screen",
"braille_translation_failed_message": "Braille translation could not refresh. Please try again.",
"braille_translation_pending_message": "Translating to Braille…",
"braille_untranslatable_modal_button_label": "Get a custom quote",
"braille_untranslatable_modal_label": "Some of your text cannot be turned into braille automatically. Send us your design and we will quote it for you.",
"cancel": "Cancel",
"char_limit_reached": "You have exceeded the maximum number of characters for the current size.",
"character_limit_message": "The maximum number of characters for this current size has been reached.",
"character_text": "characters max per line for current size",
"click_word_desktop": "Click on a word to begin customising it.",
"cm_button": "Use cm",
"colour_min_size_message": "The selected colour is only available for larger sizes.",
"colour_title": "Color",
"contact_description": "Feel free to reach out through our Live Chat, read through our FAQ page or send us an email.",
"contact_header": "Have some questions? We're here for you!",
"copy_button": "Copy",
"create_product_failed": "Something went wrong",
"creating_product": "Creating Product",
"crop_confirm": "Confirm",
"crop_modal_title": "Resize your image",
"crop_upload": "Upload your own image",
"custom_design_button_label": "Got a logo? Get a quote",
"custom_design_form_file_label": "Accepted file types include JPEG, PNG, WebP, AVIF, GIF, BMP, SVG, PDF, AI and EPS.",
"custom_design_form_file_type_error": "We cannot accept this file type. Upload a JPEG, PNG, WebP, AVIF, GIF, BMP, SVG, PDF, AI or EPS file.",
"custom_design_form_input_error": "Invalid input.",
"custom_design_form_message_error": "Form submission failed. Please try again.",
"custom_design_form_message_success": "Thank you for your submission.",
"custom_design_form_size_error": "File size cannot exceed 10MB.",
"custom_design_form_submit_message": "Submitting form, please wait.",
"custom_design_form_total_size_error": "Total file size cannot exceed 20MB.",
"custom_design_link": null,
"custom_design_steps": [
{
"header": "How it works",
"description": "Send us your artwork."
}
],
"custom_design_steps_header": "How it works",
"custom_design_tab_title": "Custom",
"custom_design_type": "form",
"custom_form_header": null,
"custom_sizing_message": "Enter text to set a custom size",
"default_background_height_cm": 300,
"default_background_width_cm": 300,
"default_text": "Start Typing",
"display_initial_background_image": true,
"display_initial_review_image": true,
"edit_design": "Edit my design",
"editing_word": "Editing",
"etsy_button": "Continue to Etsy",
"etsy_copied_button": "Copied",
"etsy_copy_details_button": "Copy details",
"etsy_customisation_summary_label": "Customisation summary",
"etsy_download_preview_button": "Download preview",
"etsy_listing_url_missing": "Your Etsy listing link hasn't been set up yet. Contact the shop to get the link.",
"etsy_preparing_image": "Preparing image",
"etsy_preview_error": "Preview couldn't be generated. Please try again.",
"etsy_return_button": "Return To Etsy To Place An Order",
"etsy_step1": "Copy your details",
"etsy_step2": "Return to Etsy",
"etsy_step3": "Paste into the personalisation box",
"etsy_suggested_price_label": "Suggested price",
"etsy_summary_colour_label": "Colour",
"etsy_summary_description": "Copy these details into the personalisation box on Etsy, then add this item to your basket there.",
"etsy_summary_design_label": "Design",
"etsy_summary_face_colour_label": "Face",
"etsy_summary_halo_colour_label": "Halo",
"etsy_summary_icon_label": "Icon",
"etsy_summary_line_label": "Line",
"etsy_summary_no": "No",
"etsy_summary_not_selected": "Not selected",
"etsy_summary_side_colour_label": "Side",
"etsy_summary_title": "Your Etsy order details",
"etsy_summary_trim_colour_label": "Trim",
"etsy_summary_tube_colour_label": "Tube",
"etsy_summary_uploaded_design_label": "Uploaded design",
"etsy_summary_yes": "Yes",
"example": "Example",
"extra_colour_exclusion_message": "The selected option is not available with this colour.",
"extras_title": "Extras",
"ai_build_accepted_formats": "JPG, PNG, WebP, AVIF, SVG, PDF (Max 5MB, 25MB for PDF)",
"ai_build_content_mismatch": "This file's contents don't match its name. Open it in your design tool and export it again rather than renaming it.",
"ai_build_credits_required_description": "This store has no AI conversion credits remaining. Please contact the store owner.",
"ai_build_credits_required_title": "Credits Required",
"ai_build_designing_description": "Turning your image into clean lines and shapes.",
"ai_build_designing_title": "Designing your sign",
"ai_build_failed_upload_desktop": "Drop another image here or tap to browse",
"ai_build_failed_upload_mobile": "Tap to choose another image",
"ai_build_form_request_button": "Submit as a form request",
"ai_build_optimising_image": "Optimising image…",
"ai_build_pdf_command_failed": "We could not read this PDF. It may be password-protected or use unsupported features. Please upload a PNG, JPG, or SVG, or a flattened PDF.",
"ai_build_pdf_invalid": "This PDF could not be read. Please upload a PNG, JPG, or SVG, or a flattened PDF.",
"ai_build_pdf_too_large": "We could read this PDF, but it becomes too large to process as an image. Please upload a simpler PDF or a PNG, JPG, or SVG under {limit}MB.",
"ai_build_pdf_unavailable": "PDF rasterisation is temporarily unavailable. Please upload a PNG, JPG, or SVG instead.",
"ai_build_pricing_unverified": "Your design pricing could not be verified. Please upload it again.",
"ai_build_progress_description": "We will add it to the editor when it is ready.",
"ai_build_progress_title": "Creating your design",
"ai_build_provider_refused_description": "Our AI can't recreate this image, often because of copyright. Try another image, or send it using the form below.",
"ai_build_provider_refused_no_form_description": "Our AI can't recreate this image, often because of copyright. Try another image.",
"ai_build_ready_description": "Your design is ready.",
"ai_build_ready_title": "Putting it all together",
"ai_build_refining_description": "Detailed images take a little longer.",
"ai_build_refining_title": "Refining your design",
"ai_build_refused_description": "Send it to us with the form and we'll design it for you.",
"ai_build_refused_title": "We can't make this one automatically",
"ai_build_remove_image": "Remove image",
"ai_build_review_required_description": "We couldn't turn this image into a production-ready design. Try again or choose another image.",
"ai_build_review_required_title": "Design review required",
"ai_build_save_form_save_version": "Save this version",
"ai_build_save_form_saved_description": "We have your details. We will contact you about your design.",
"ai_build_save_form_saved_title": "Your design is saved",
"ai_build_saved_close_note": "Your design is saved. You can close this page.",
"ai_build_saved_note": "Your image is saved. Keep this page open.",
"ai_build_svg_text_elements": "Text elements are not supported. Convert text to outlines in the SVG.",
"ai_build_throttled_description": "Wait a few minutes and try again — there is nothing wrong with your image.",
"ai_build_throttled_title": "Too many uploads just now",
"ai_build_unsupported_file_type": "We can't read that file type. Save your artwork as a JPG, PNG, WebP, AVIF, SVG, or PDF and upload it again.",
"ai_build_uploaded_artwork": "Uploaded artwork",
"ai_build_width_above_maximum": "This design needs a sign no wider than {width}. Choose a smaller size.",
"ai_build_width_below_minimum": "This design needs a sign at least {width} wide. Choose a larger size.",
"ai_build_width_unconfirmed": "We cannot confirm the size of this design. Choose a different size.",
"file_label": "Upload your logo",
"file_upload_label": "Drop an image here or tap to browse",
"font_title": "Font",
"generating_image": "Generating Image",
"header_text": "CREATE YOUR CUSTOM SIGN",
"height_input": "Height",
"highlights": [
"Handmade",
"12-month warranty",
"Free shipping"
],
"icon_button_label": "Icons",
"icon_title": "Icons",
"inch_button": "Use inches",
"inclusions": "Your Custom Sign\nPower Supply\nDigital Installation Guide\nFree Express Shipping\n12-Month Warranty",
"inclusions_header": "What's included in your custom sign?",
"invalid_characters": "Text contains invalid characters: {characters}. Please try another font.",
"emoji_not_allowed": "Emojis are not supported on this sign: {characters}. Remove them to continue.",
"jacket_colour_exclusion_message": "The selected jacket option is not available for this colour.",
"jacket_title": "Jacket",
"label_under_price": "",
"left_side": "Left",
"letter_parts_description": "",
"letter_parts_title": "",
"lightbox_product_type_title": "Lightbox",
"line_limit_reached": "You have exceeded the maximum number of lines for the current size.",
"lines_text": "lines",
"loading_manual_clear_text": "Your design is being added to the cart. Please wait...",
"logo_button_text": "Submit Custom Design",
"logo_text": "To Submit a Custom Design, please click on the button below",
"logo_upload_design_ready": "Design Ready!",
"logo_upload_failed_description": "Fill out the form to send us an inquiry, we'll automatically attach this image",
"logo_upload_failed_title": "We couldn't process your image",
"logo_upload_file_too_large": "This file is too large. Choose a file up to {limit} MB.",
"logo_upload_pending_description": "Depending on the complexity of the image, this may take a few minutes.",
"logo_upload_pending_title": "Processing your image",
"logo_upload_try_another": "Try another image",
"main_tab_title": "Text",
"manual_button": "Enter dimensions manually",
"material_mounting_exclusion_message": "The selected material is not available with this mounting option.",
"material_support_exclusion_message": "The selected material is not available with this backboard.",
"material_title": "Material",
"max_sign_char": "characters max",
"max_sign_modal_button_label": "Get a quote",
"max_sign_modal_button_link": null,
"max_sign_modal_label": "Size is over the limit. Contact us for a quote.",
"min_character_message": "or more characters are required for this size, please add more characters.",
"min_height_sign_warning": "The overall sign height is too small. Please increase the height.",
"mounting_colour_exclusion_message": "The selected mounting option is not available with this colour.",
"mounting_colour_min_size_message": "This colour requires a larger sign size.",
"mounting_colour_title": "Mounting colour",
"mounting_letter_part_title": "Mounting Side",
"mounting_support_exclusion_message": "The selected mounting option is not available with this backboard.",
"mounting_title": "Mounting",
"options_tab": "Options",
"preview_note": "Colours may appear different in real life",
"price": "",
"price_after_label": "",
"price_box_text": "Free shipping, One year guarantee",
"price_button_add": "Add to Bag",
"price_button_buy_now": "Buy it now",
"price_button_finish": "Finish",
"product_title": "Custom Sign:",
"product_type_title": "Letter Type",
"qualities": [
{
"header": "How it works",
"description": "Send us your artwork."
}
],
"qualities_header": "Good to know",
"quote_button": "Finalize Quote",
"real_size_caption": "The person is {height} tall. Change the sign size in the sidebar to see it here.",
"real_size_description": "The sign is shown next to a person who is {height} tall.",
"real_size_no_room": "Make the preview larger to see the real size.",
"real_size_sign_size": "The sign is {size}.",
"real_size_unavailable": "Make your design first to see its real size.",
"recenter": "Recenter",
"recenter_warning": "Click to reset position",
"retry": "Try Again",
"right_side": "Right",
"rotation": "Rotation",
"shape_finished_size": "Finished size: {width} × {height} {unit}",
"shape_proportions_fixed_by": "Proportions fixed by {shape}",
"shape_size_adjusted_to_fixed_proportions": "Your saved size was adjusted to match this shape’s fixed proportions.",
"shape_size_adjusted_to_range": "Size adjusted to fit the available range.",
"shape_sizing_empty_feasible_range": "This shape cannot be sized within the available minimum and maximum dimensions.",
"shape_sizing_invalid_canonical_bounds": "This shape is unavailable because its proportions could not be loaded.",
"shape_sizing_invalid_intent": "Enter a valid size to continue.",
"shape_sizing_preset_requires_custom": "Choose a custom size for this shape.",
"share_design": "Share my design",
"share_design_modal_description": "",
"share_design_modal_title": "Share Your Design",
"show_background_preview": true,
"show_contact_section": true,
"show_custom_design": true,
"show_custom_design_link": true,
"show_inclusion_section": true,
"show_preview_note": true,
"show_review_images": true,
"show_review_section": true,
"show_styled_note": true,
"show_text_editor_overlay": true,
"sign_header": "YOUR SIGN",
"size_title": "Size",
"slider_button": "Switch back to slider",
"summary_header": "YOUR SIGN DETAILS:",
"support_colour_min_size_message": "The selected backboard colour is only available for larger sizes.",
"support_colour_title": "Backboard Color",
"support_title": "Backboard",
"tap_word_mobile": "Tap on a word to begin customising it.",
"text_align_center": "Center",
"text_align_left": "Left",
"text_align_right": "Right",
"text_align_title": "Text Align",
"text_button_label": "Got a text sign? Customise now",
"text_label": "Write your text",
"text_orientation_horizontal": "Horizontal",
"text_orientation_title": "Orientation",
"text_orientation_vertical_stacked": "Vertical",
"text_template_custom_width": "Width ({unit})",
"text_template_custom_width_range": "Type a width from {min} to {max}.",
"text_template_field_outside_frame": "The text goes outside the sign. Make the text shorter.",
"text_template_field_overflow_larger": "The text does not fit in the space for this field. Make the text shorter or select a larger size.",
"text_template_fields_overlap": "The text touches the text of a different field. Make the text shorter.",
"text_template_lettering_not_priced": "The text is larger than the sizes you can order. Make the text shorter or select a smaller size.",
"text_template_field_letters_touch": "The letters touch on this curve. Change the text.",
"text_template_field_letters_touch_larger": "The letters touch on this curve. Select a larger size or change the text.",
"text_template_lettering_size": "Lettering: {size}",
"text_template_diameter_size": "{size} diameter",
"text_template_custom_diameter": "Diameter ({unit})",
"text_template_custom_diameter_range": "Type a diameter from {min} to {max}.",
"text_template_letter_height": "Letter height: {size}",
"text_template_finish_title": "Finish",
"text_template_diameter_title": "Diameter",
"text_template_merchant_artwork": "Design artwork",
"text_template_size_unavailable": "This size is not available for this design. Select a different size.",
"text_template_field_overflow": "The text does not fit in the space for this field. Make the text shorter.",
"text_template_field_required": "Type the text for this field.",
"text_template_field_too_long": "The text has more than {max} characters. Make the text shorter.",
"text_template_font_failed": "The font did not load. Select a different font.",
"text_template_order_unavailable": "We could not check this design. Add it to the cart again.",
"text_template_restart": "Start again with the current design",
"text_template_superseded": "The sign design changed after you saved your text. Start again with the current design.",
"text_template_keep_out_overlap": "The text is too near a mounting hole. Change the text.",
"text_template_lettering_covered": "The frame covers part of the text. Change the text.",
"text_template_not_one_piece": "Some parts of the letters do not touch the frame. Change the text.",
"text_template_structure_failed": "We cannot show this design. Contact us.",
"text_template_graphic_required": "Add artwork to this area.",
"text_template_graphic_failed": "We cannot show this artwork. Contact us.",
"text_template_graphic_touches_lettering": "The artwork touches the text. Move the artwork or make it smaller.",
"text_template_graphic_horizontal": "Horizontal position",
"text_template_graphic_vertical": "Vertical position",
"text_template_graphic_size": "Size",
"text_template_graphic_reset": "Reset position",
"text_template_customer_artwork": "Your artwork",
"text_template_graphic_upload": "Upload your artwork",
"text_template_graphic_processing": "We are making your artwork into a shape to cut. This can take some minutes.",
"text_template_graphic_upload_failed": "We cannot use this artwork. Try again, or keep the current artwork.",
"text_template_graphic_upload_wait": "There are too many uploads now. Wait some minutes, then try again.",
"text_template_graphic_upload_unavailable": "You cannot upload artwork now.",
"text_template_graphic_retry": "Try again",
"text_template_graphic_keep_current": "Keep current artwork",
"text_template_graphic_use_default": "Use design artwork",
"text_template_font_for": "Font for {field}",
"text_template_font_every_line": "Use for every line",
"text_template_artwork_not_makeable": "We cannot cut this artwork in the sign. Move the artwork or use different artwork.",
"text_template_field_too_fine": "The letters are too thin or too close together to cut. Change the text.",
"text_template_metal_too_fine": "Some parts of the sign are too thin or too close together to cut. Change the text.",
"curved_text_label": "Curve",
"curved_text_line_label": "Curve for line {line}",
"curved_text_straight": "Straight",
"curved_text_reset_positions": "Reset positions",
"curved_text_straighten_all": "Make all lines straight",
"curved_text_straighten_line": "Make this line straight",
"curved_text_icon_on_curved_line": "You cannot add an icon to a curved line. Make this line straight to add the icon.",
"curved_text_value_up": "Curve up, {degrees} degrees",
"curved_text_value_down": "Curve down, {degrees} degrees",
"curved_text_readout_up": "Up {degrees}°",
"curved_text_readout_down": "Down {degrees}°",
"curved_text_vertical_blocked": "Make all lines straight to use vertical text.",
"curved_text_font_failed": "The font did not load. Select a different font, or make the line straight.",
"curved_text_block_feature_off": "Curved text is not available.",
"curved_text_block_unsupported_sign": "Curved text is not available for this sign.",
"curved_text_block_vertical_orientation": "Curved text is not available for vertical text.",
"curved_text_block_rtl": "Curved text is not available for right-to-left text.",
"curved_text_icon_on_line": "Remove the icon from this line to curve it.",
"curved_text_moved_words": "You moved or turned some words. Reset the positions to curve this line.",
"curved_text_empty_line": "Type text on this line to curve it.",
"curved_text_conflict_feature_off": "Curved text is not available. Make all lines straight to order.",
"curved_text_conflict_unsupported_sign": "Curved text is not available for this sign. Make all lines straight to order.",
"curved_text_conflict_vertical_orientation": "Curved text is not available for vertical text. Make all lines straight to order.",
"curved_text_conflict_rtl": "Curved text is not available for right-to-left text. Make all lines straight to order.",
"curved_text_font_pending": "The font is loading. Wait a moment.",
"curved_text_shaping_failed": "This font cannot make curved text. Select a different font, or make the line straight.",
"curved_text_missing_space_glyph": "This font cannot make curved text with spaces. Select a different font, or make the line straight.",
"curved_text_sweep_too_tight": "The curve is too tight for this text. Make the curve smaller.",
"curved_text_glyph_collision": "The curve is too tight for these letters. Make the curve smaller.",
"curved_text_field_radius_too_small": "The circle for this text field is too small for its letters.",
"curved_text_letter_reference_missing": "This font cannot set the letter height. Select a different font.",
"curved_text_incorrect_curve": "The curve on this line is not correct. Make it straight.",
"curved_text_order_font_failed": "We cannot show the curved text. Make the line straight, or select a different font.",
"curved_text_order_icon_on_line": "Remove the icon from the curved line, or make the line straight.",
"curved_text_order_empty_line": "Type text on the curved line, or make the line straight.",
"curved_text_order_incorrect_curve": "The curve on one line is not correct. Make the line straight.",
"text_title": "Text",
"top_side": "Top",
"upload_background": "Upload Background",
"uploading_images": "Uploading Images",
"user_bg_scale_cancel": "Cancel",
"user_bg_scale_continue": "Continue",
"user_bg_scale_description": "Specify the width and height this image represents in order to see your sign at a realistic scale.",
"user_bg_scale_error": "Width and height must be numbers greater than 0.",
"user_bg_scale_title": "Relative Scale",
"view_switch_design": "Design",
"view_switch_real_size": "Real size",
"visualiser_off": "Off",
"visualiser_on": "On",
"width_input": "Width",
"zoom_in": "Zoom In",
"zoom_out": "Zoom Out",
"default_background_width_in": 118.1102362,
"default_background_height_in": 118.1102362,
"authored_units": {
"default_background_width_cm": "centimetres",
"default_background_height_cm": "centimetres"
},
"additional_information": [
{
"header": "Free express shipping",
"description": "Every sign ships free, worldwide.",
"image_url": "https://cdn.signcustomiser.com/labels/shipping.png"
}
],
"background_images": [
{
"name": "brick-wall.jpg",
"image_url": "https://cdn.signcustomiser.com/labels/brick-wall.jpg",
"width_cm": 152.4,
"height_cm": 101.6,
"sign_area": {
"x": 0.2,
"y": 0.3,
"w": 0.6,
"h": 0.4
},
"linked_size_ids": [
1201,
1202
],
"is_default_background": false,
"mobile": {
"image_url": "https://cdn.signcustomiser.com/labels/brick-wall-mobile.jpg",
"width_cm": 91.4,
"height_cm": 121.9,
"sign_area": {
"x": 0.1,
"y": 0.25,
"w": 0.8,
"h": 0.3
},
"width_in": 36,
"height_in": 48,
"authored_units": {
"width_cm": "inches",
"height_cm": "inches"
}
},
"width_in": 60,
"height_in": 40,
"authored_units": {
"width_cm": "inches",
"height_cm": "inches"
}
}
],
"product_image_url": "https://cdn.signcustomiser.com/labels/product.png",
"updated_at": "2026-05-04T09:12:31Z"
},
"links": {
"self": "https://web.signcustomiser.com/api/v3/customisers/42/labels/product-image",
"documentation": "https://www.signcustomiser.com/help/api/"
},
"meta": {
"api_version": "v3",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
}{
"type": "https://www.signcustomiser.com/help/api/problems/missing_idempotency_key",
"title": "Missing idempotency key",
"status": 400,
"code": "missing_idempotency_key",
"detail": "Provide an Idempotency-Key header for this write.",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/missing_api_key",
"title": "Missing API key",
"status": 401,
"code": "missing_api_key",
"detail": "Provide a store API key as a bearer token.",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/insufficient_scope",
"title": "Insufficient scope",
"status": 403,
"code": "insufficient_scope",
"detail": "This operation requires the customisers:write scope.",
"required_scopes": [
"customisers:write"
],
"granted_scopes": [
"customisers:read"
],
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/resource_not_found",
"title": "Resource not found",
"status": 404,
"code": "resource_not_found",
"detail": "The requested resource does not exist or does not belong to the authenticated store.",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/upload_already_attached",
"title": "Upload already attached",
"status": 409,
"code": "upload_already_attached",
"detail": "This upload has already been attached to a file slot. Each upload is single use: create a new upload for each assignment.",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/upload_purpose_mismatch",
"title": "Upload purpose mismatch",
"status": 422,
"code": "upload_purpose_mismatch",
"detail": "This slot accepts uploads created with purpose label_image, and this upload was created with purpose option_image. Create a new upload with the slot's purpose.",
"errors": [
{
"pointer": "/upload_id",
"code": "upload_purpose_mismatch",
"detail": "The upload's purpose is option_image.",
"allowed_values": [
"label_image"
]
}
],
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/rate_limited",
"title": "Too many requests",
"status": 429,
"code": "rate_limited",
"detail": "You have exceeded the request limit for this API key.",
"retry_after": 37,
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}