{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown","redocly_category":"Guides","api_domain":"Cross API"},"seo":{"title":"Quickstart","description":"Make your first authenticated request to Sales Layer REST APIs.","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":"quickstart","__idx":0},"children":["Quickstart"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this quickstart to make a first authenticated request and confirm that your integration can reach Sales Layer REST APIs."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you start, make sure you have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Sales Layer account with REST API access."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A valid API key."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A tool that can send HTTPS requests, such as cURL, Postman, or an integration runtime."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"base-url","__idx":2},"children":["Base URL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All requests in this documentation use the current API base URL:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"https://api2.saleslayer.com\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication-header","__idx":3},"children":["Authentication header"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send the API key in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-API-KEY"]}," header."]},{"$$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":["Do not include API keys in browser code, public repositories, screenshots, or customer-facing logs."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"make-a-first-request","__idx":4},"children":["Make a first request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Start with a small DAM request to verify authentication, connectivity, and response handling."]},{"$$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":"p","attributes":{},"children":["This request returns up to 10 image records when the API key has access to the DAM API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"expected-result","__idx":5},"children":["Expected result"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A successful request returns an HTTP ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200 OK"]}," response with a JSON payload."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the request fails:"]},{"$$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":"Status code"},"children":["Status code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What to check first"},"children":["What to check first"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query parameter syntax and supported values."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-API-KEY"]}," header is present and contains the correct key."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The endpoint path and resource identifier are correct."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["409"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The resource is not locked by a temporary processing state. Applies to write operations only, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE /dam/image/{id}"]},". Not returned by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /dam/image"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retry only with bounded backoff and log the failure for investigation."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"try-the-catalog-api","__idx":6},"children":["Try the Catalog API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For Catalog integrations, use metadata before building dynamic requests."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET 'https://api2.saleslayer.com/catalog/rest/Catalog/$metadata' \\\n  -H 'X-API-KEY: YOUR_API_KEY'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Metadata responses help integrations understand available fields, resource structures, and relationships before requesting or writing catalog data."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":7},"children":["Next steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$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/headers"},"children":["Headers"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/base-url"},"children":["Base URL"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/recipes"},"children":["Recipes"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis"},"children":["API reference overview"]}]}]}]},"headings":[{"value":"Quickstart","id":"quickstart","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Base URL","id":"base-url","depth":2},{"value":"Authentication header","id":"authentication-header","depth":2},{"value":"Make a first request","id":"make-a-first-request","depth":2},{"value":"Expected result","id":"expected-result","depth":2},{"value":"Try the Catalog API","id":"try-the-catalog-api","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Quickstart","description":"Make your first authenticated request to Sales Layer REST APIs."},"keywords":{"includes":["quickstart","first request","curl","API key"]},"metadata":{"redocly_category":"Guides","api_domain":"Cross API"}},"lastModified":"2026-06-04T20:25:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/quickstart","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}