{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown","redocly_category":"Guides","api_domain":"Cross API"},"seo":{"title":"Authentication","description":"How to authenticate Sales Layer REST API requests using the X-API-KEY header.","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":"authentication","__idx":0},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sales Layer REST API operations require an API key sent in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-API-KEY"]}," request header."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API key identifies the customer account and authorizes access to the APIs available for that account."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"required-header","__idx":1},"children":["Required header"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send the API key in every request:"]},{"$$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":"p","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YOUR_API_KEY"]}," with the key provided for your Sales Layer account."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-request","__idx":2},"children":["Example request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET 'https://api2.saleslayer.com/dam/image?$top=10' \\\n  -H 'X-API-KEY: YOUR_API_KEY'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-to-obtain-an-api-key","__idx":3},"children":["How to obtain an API key"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To obtain an API key, contact Sales Layer support or your account representative."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this email address:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"support@saleslayer.com\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When requesting access, include enough context for the Sales Layer team to identify the account and the intended integration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Recommended information:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Customer or account name."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Environment or project where the integration will run."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["API areas needed, such as DAM, Catalog, or both."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Short description of the integration use case."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Technical contact for follow-up questions."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"security-recommendations","__idx":4},"children":["Security recommendations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treat API keys as secrets:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not expose API keys in frontend code, public repositories, screenshots, or logs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Store API keys in a secret manager or protected environment variable."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Restrict access to the key to the systems and people that need it."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Rotate the key if it may have been exposed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use separate keys per environment when available."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"failed-authentication","__idx":5},"children":["Failed authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Requests without a valid API key are rejected."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Common causes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-API-KEY"]}," header is missing."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The header value is empty."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The key was copied with extra spaces or hidden characters."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The key is not valid for the target account or API."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The key has been revoked or replaced."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting-checklist","__idx":6},"children":["Troubleshooting checklist"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before contacting support, verify:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The request is sent to the correct base URL."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-API-KEY"]}," header is present in the final HTTP request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The key value is not surrounded by quotes unless your HTTP client requires them."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The key is loaded correctly from your deployment environment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The same request works in a controlled tool such as curl or Postman."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"support","__idx":7},"children":["Support"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For technical support, API questions, or help getting access to an API key, contact Sales Layer support or your account representative."]}]},"headings":[{"value":"Authentication","id":"authentication","depth":1},{"value":"Required header","id":"required-header","depth":2},{"value":"Example request","id":"example-request","depth":2},{"value":"How to obtain an API key","id":"how-to-obtain-an-api-key","depth":2},{"value":"Security recommendations","id":"security-recommendations","depth":2},{"value":"Failed authentication","id":"failed-authentication","depth":2},{"value":"Troubleshooting checklist","id":"troubleshooting-checklist","depth":2},{"value":"Support","id":"support","depth":2}],"frontmatter":{"seo":{"title":"Authentication","description":"How to authenticate Sales Layer REST API requests using the X-API-KEY header."},"keywords":{"includes":["authentication","API key","X-API-KEY"]},"metadata":{"redocly_category":"Guides","api_domain":"Cross API"}},"lastModified":"2026-06-03T15:57:05.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/authentication","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}