{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown","redocly_category":"Guides","api_domain":"DAM"},"seo":{"title":"DAM error details","description":"DAM REST API image operation error details and troubleshooting guidance.","keywords":["Sales Layer","REST API","OpenAPI","DAM API","Catalog API","product catalog API","image management API","API integration"],"lang":"en-US","meta":[{"name":"og:type","content":"website"},{"name":"og:site_name","content":"Sales Layer REST API Documentation"},{"name":"og:title","content":"Sales Layer REST API Documentation"},{"name":"og:description","content":"Complete REST API documentation for Sales Layer's DAM and Catalog APIs. Learn authentication, pagination, filtering, and integration patterns."},{"name":"twitter:card","content":"summary_large_image"},{"name":"twitter:site","content":"@saleslayer"},{"name":"twitter:title","content":"Sales Layer REST API Documentation"},{"name":"twitter:description","content":"Complete REST API documentation for Sales Layer's DAM and Catalog APIs. Learn authentication, pagination, filtering, and integration patterns."}],"llmstxt":{"hide":false,"title":"Sales Layer REST API Documentation","description":"Technical guides and OpenAPI references for Sales Layer DAM and Catalog REST APIs.","sections":[{"title":"Guides","description":"Static API guides for authentication, headers, query parameters, responses, rate limiting, and best practices.","includeFiles":["guides/**/*.md","changelog.md"],"excludeFiles":[]},{"title":"API Reference","description":"OpenAPI-based references and API overview pages for Sales Layer REST APIs.","includeFiles":["apis/**/*.md","apis/**/*.yaml"],"excludeFiles":[]},{"title":"Postman collections","description":"Importable Postman collection and environment instructions for testing Sales Layer REST APIs.","includeFiles":["postman/**/*.md"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"dam-error-details","__idx":0},"children":["DAM error details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page lists DAM REST API error details for image operations."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For cross-API status code guidance, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/error-responses"},"children":["Error responses"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The DAM REST API uses standard HTTP status codes to indicate whether a request succeeded or failed."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When an operation fails, first check:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-API-KEY"]}," header"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Path and query parameter values"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Whether the target image exists"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Whether the image is currently being processed"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-response-format","__idx":1},"children":["Error response format"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Most error responses use a JSON problem-details structure."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"type\": \"https://api2.saleslayer.com/errors/validation\",\n  \"title\": \"Bad Request\",\n  \"status\": 400,\n  \"detail\": \"The request is invalid.\",\n  \"instance\": \"/image/123\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The OpenAPI specification defines a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ProblemDetails"]}," schema with these fields:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["detail"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instance"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"400-bad-request","__idx":2},"children":["400 Bad Request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The request is syntactically valid HTTP, but the API cannot process it because one or more values are invalid."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Common causes:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"get-image","__idx":3},"children":["GET ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/image"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Invalid ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$filter"]}," syntax"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Unsupported field in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$orderby"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Invalid pagination values such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$top"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$skip"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Invalid API key"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"delete-imageid","__idx":4},"children":["DELETE ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/image/{id}"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Invalid image identifier"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Invalid request"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"401-unauthorized","__idx":5},"children":["401 Unauthorized"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The request does not include a valid API key."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Typical causes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Missing ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-API-KEY"]}," header"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Empty API key value"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Invalid API key"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"X-API-KEY: YOUR_API_KEY\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"404-not-found","__idx":6},"children":["404 Not Found"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The requested image does not exist or cannot be found for the current tenant."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This can happen when:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The image identifier is wrong"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The image has already been deleted"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The image does not belong to the current tenant context"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"409-conflict","__idx":7},"children":["409 Conflict"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The operation cannot be completed because the image is currently being processed."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the DAM API this status is relevant for:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE /image/{id}"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This usually means the image is temporarily locked by an active processing workflow. Retry later."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"500-internal-server-error","__idx":8},"children":["500 Internal Server Error"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The server encountered an unexpected error while processing the request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Typical causes include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Network connectivity issues"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Storage service unavailable"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Database errors"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500"]}," response usually indicates a temporary or server-side problem rather than a client-side validation issue."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpoint-summary","__idx":9},"children":["Endpoint summary"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Endpoint"},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Possible error codes"},"children":["Possible error codes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /image"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE /image/{id}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["409"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting-checklist","__idx":10},"children":["Troubleshooting checklist"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before retrying a failed request, verify:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-API-KEY"]}," header is present and valid"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The endpoint path is correct"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The image ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," is valid when using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Query parameters are supported and correctly formatted"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-pages","__idx":11},"children":["Related pages"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/introduction"},"children":["Introduction"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/authentication"},"children":["Authentication"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/rate-limiting"},"children":["Rate limiting"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/error-responses"},"children":["Error responses"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis"},"children":["API reference overview"]}]}]}]},"headings":[{"value":"DAM error details","id":"dam-error-details","depth":1},{"value":"Error response format","id":"error-response-format","depth":2},{"value":"400 Bad Request","id":"400-bad-request","depth":2},{"value":"GET /image","id":"get-image","depth":3},{"value":"DELETE /image/{id}","id":"delete-imageid","depth":3},{"value":"401 Unauthorized","id":"401-unauthorized","depth":2},{"value":"404 Not Found","id":"404-not-found","depth":2},{"value":"409 Conflict","id":"409-conflict","depth":2},{"value":"500 Internal Server Error","id":"500-internal-server-error","depth":2},{"value":"Endpoint summary","id":"endpoint-summary","depth":2},{"value":"Troubleshooting checklist","id":"troubleshooting-checklist","depth":2},{"value":"Related pages","id":"related-pages","depth":2}],"frontmatter":{"seo":{"title":"DAM error details","description":"DAM REST API image operation error details and troubleshooting guidance."},"keywords":{"includes":["DAM errors","image errors","troubleshooting","status codes"]},"metadata":{"redocly_category":"Guides","api_domain":"DAM"}},"lastModified":"2026-06-04T20:25:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/errors","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}