Products
Retry a product's production files
Starts the derived production files of a retained-metal template product
again, as the merchant admin's Retry button on the product does. Only a
package that failed, or one that has stayed pending longer than
expected, is started again: the response is 202 with the package back
at pending.
Overview
For a package that cannot be retried now, nothing is
queued and the response is 200 with the package as it stands. A
product that owes no derived production files answers 409
no_production_package. Read production_package on
GET/api/v3/products/{product_id} to see the state.
Requires products:write. The body must be empty or {}. An optional
Idempotency-Key replays the first response. Attempts are limited to
six per API key per minute, as in the merchant admin; a refused attempt
counts, and a replay does not.
Authorisation
Bearer token required. Include it in the Authorization header.
Required scope: products:write
Path parameters
Product id returned by the list operation.
Example: 731
curl https://web.signcustomiser.com/api/v3/products/731/production-files/retry \
--request POST \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN'{
"data": {
"object": "production_package",
"status": "pending",
"files": [
{
"type": "cut_outline_dxf",
"status": "pending"
}
],
"can_retry": false,
"delayed": false,
"held_order_emails": 1,
"updated_at": "2026-07-18T03:20:00Z"
},
"links": {
"self": "https://web.signcustomiser.com/api/v3/products/731/production-files/retry",
"documentation": "https://www.signcustomiser.com/help/api/"
},
"meta": {
"api_version": "v3",
"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 products:write scope.",
"required_scopes": [
"products:write"
],
"granted_scopes": [
"products: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/no_production_package",
"title": "No production package",
"status": 409,
"code": "no_production_package",
"detail": "This product has no production files to retry.",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/unknown_field",
"title": "Unknown request field",
"status": 422,
"code": "unknown_field",
"detail": "This operation accepts no request fields.",
"errors": [
{
"parameter": "format",
"code": "unknown_field",
"detail": "The request field format is not supported by this endpoint."
}
],
"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": 60,
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}