Upload PSD

1// PSD download failed
2{
3  "error_code": "PSD_DOWNLOAD_FAILED",
4  "message": "Failed to download PSD file",
5  "detail": "Failed to download PSD file",
6  "details": {
7    "url": "https://example.com/broken-link.psd",
8    "reason": "HTTP 404",
9    "suggestion": "Check if the URL is accessible and the file exists"
10  },
11  "success": false
12}
13
14// No visible personalizable layers
15{
16  "error_code": "NO_SMART_OBJECTS",
17  "message": "The PSD has no visible personalizable layers.",
18  "detail": "The PSD has no visible personalizable layers.",
19  "details": {
20    "total_layers": 12,
21    "hidden_smart_objects": 0,
22    "suggestion": "Make at least one personalizable layer visible, then upload the PSD again."
23  },
24  "success": false
25}

1{
2  "detail": "Not authenticated",
3  "success": false
4}

1{
2  "error": "credits_exhausted",
3  "message": "You have used all 500 trial credits. Add a payment method to keep rendering, or start a plan.",
4  "actions": [
5    { "label": "Add a payment method", "url": "https://sudomock.com/dashboard/billing?action=topup#payg-section" },
6    { "label": "Start a plan", "url": "https://sudomock.com/pricing" }
7  ]
8}

1{
2  "success": false,
3  "error": {
4    "code": "psd_limit_reached",
5    "message": "Your account is in trial, so you can store 5 PSD templates. Existing templates keep working.",
6    "suggestion": "Delete a template, or add a payment method to raise this limit."
7  }
8}

1{
2  "success": false,
3  "error": {
4    "code": "psd_limit_reached",
5    "message": "You have reached your PSD template limit of 500. Existing templates keep working.",
6    "suggestion": "Delete a template, or move to a plan with a higher limit."
7  }
8}

1{
2  "error_code": "PSD_TOO_LARGE",
3  "message": "PSD file exceeds the maximum allowed size",
4  "detail": "PSD file exceeds the maximum allowed size",
5  "details": {
6    "max_size_mb": 300,
7    "suggestion": "Reduce the file size (flatten non-editable layers) and try again."
8  },
9  "success": false
10}

1{
2  "detail": "Validation error",
3  "errors": [
4    {"field": "body -> psd_file_url", "message": "Missing required field: body -> psd_file_url"}
5  ],
6  "success": false
7}

1{
2  "error_code": "LINKED_SMART_OBJECT_CONTENT_MISSING",
3  "message": "A linked smart object has no usable placement geometry",
4  "detail": "A linked smart object has no usable placement geometry",
5  "details": {
6    "suggestion": "Embed the linked smart object in Photoshop (Layer > Smart Objects > Embed Linked), or supply the design via the render request. Retrying the same file will not help."
7  },
8  "success": false
9}

1{
2  "detail": "Rate limit exceeded. Please slow down and try again.",
3  "error": {
4    "type": "rate_limit_exceeded",
5    "code": "RATE_LIMIT_EXCEEDED",
6    "limit": 1000,
7    "remaining": 0,
8    "reset_seconds": 30,
9    "retry_after": 30,
10    "resource": "api"
11  }
12}

1{
2  "error_code": "INTERNAL_ERROR",
3  "message": "An unexpected error occurred while processing the PSD file",
4  "detail": "An unexpected error occurred while processing the PSD file",
5  "details": {
6    "suggestion": "Please try again. If the problem persists, contact support."
7  },
8  "success": false
9}