{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-sai/xm-cloud-content/content-management-api/index.yaml","sidebar":"sidebar-sidebar.yaml__sai_xm-cloud-content_content-management-api","current-catalog-info":"current-catalog-info-/sai/xm-cloud-content/content-management-api"},"props":{"definitionId":"sai/xm-cloud-content/content-management-api/index.yaml","dynamicMarkdocComponents":[],"baseSlug":"/sai/xm-cloud-content/content-management-api","seo":{"title":"Content Management API","siteUrl":"https://api-docs.sitecore.com","image":"/assets/favicon.19b81ef710429ff2169b164acdb39de23d65db39632db445eeef84aa38980a00.db81178d.svg","keywords":"documentation, api","lang":"en-US","jsonLd":{"@context":"https://schema.org","@type":"Website","url":"http://api-docs.sitecore.com","name":"Sitecore APIs Documentation"},"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"itemId":"","disableAutoScroll":true,"metadata":{"type":"openapi","title":"Content Management API","description":"Use the XM Cloud Content Management API to build a content model that structures and organizes your data. Content types make up the content model while the content items contain the data itself. The API definitions are written in JSON.\n{% admonition type=\"info\" name=\"Note\" %}A `name` field can be alphanumeric, and can contain periods, underscores, and hyphens, but not spaces or other special characters. It cannot start with an underscore. The `dateTime` format is ISO 8601.  {% /admonition %}\n## Authentication\n\nTo use this REST API, you must authorize your API requests. To do this, you\nneed the following information:\n\n - The URL of your XM Cloud Content server (for example, `cs-cmapi.sitecorecloud.io` or a [custom hostname](https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/custom-hostnames.html)).\n - The environment ID (for example, `main`).\n\nTo use the <b>Try it</b> feature, enter this information on the <b>Environments</b> tab, by hovering your mouse over the variable and then clicking <b>Edit</b>.\nTokens are used for API security. You need to generate an OAuth client bearer token and use it to authenticate. A successful authentication request requires the following credential properties: `oauth2_client_id`, the `oauth2_client_secret`, or an `oauth2_token`.\n### Create an OAuth client bearer token\n\n{% admonition type=\"info\" name=\"Note\" %}The <b>Settings</b> menu is only\nvisible if you have the <i>Admin</i> role.{%\n  /admonition %}\n\nTo create an OAuth client bearer token:\n\n 1. In XM Cloud Content, on the menu bar, click <b>Settings</b>.\n 2. In the left pane, click <b>Content management API</b>.\n 3. On the <b>Content management API</b> page, in the <b>Grant type</b> section, click <b>Client credentials</b>.\n 4. Copy the following credentials and paste them into your development tool, and then execute the <b>Generate token</b> method:\n\n    - <b>Client ID</b> - The client ID for XM Cloud Content.\n    - <b>Client secret</b> - The client secret for the XM Cloud Content.\n    - <b>Audience</b> - The audience for your tenant. This will be in the form `https://api.sitecorecloud.io`.\n    - <b>Authority</b> - The authority for your tenant. This is the POST URL, in the form `https://auth.sitecorecloud.io/oauth/token`.","product":"SitecoreAI Content"},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"api-docs.sitecore.com","port":4000,"ipAddress":"216.73.216.68"},"lang":"default_locale","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"master"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/sai/xm-cloud-content/content-management-api","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}