{"items":[{"type":"link","label":"Content Items API","link":"/sai/content-items-api","routeSlug":"/sai/content-items-api","content":{"contentType":"overview","meta":{"name":"Content Items API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"index.json","url":"/_bundle/sai/content-items-api/index.json?download"},{"kind":"download","label":"index.yaml","url":"/_bundle/sai/content-items-api/index.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[{"kind":"externallink","title":"License","titleTranslationKey":"info.license","label":"Apache 2.0","url":"https://www.apache.org/licenses/LICENSE-2.0"}]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Content Items API (v1)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Content Items API lets you manage content items for an environment. A content item is an instance of a content type that stores structured content and its metadata. Content items contain the actual content used by sites, applications, and other channels."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This REST API lets you:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create, retrieve, update and delete content items."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List live content items."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Validate and translate content items."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieve content item hierarchy and hierarchy children."},"children":[]}]}]}]}]}]}],"sectionId":"/sai/content-items-api"}],"sectionId":"/sai/content-items-api"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":1,"id":"section/authorization"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authorization"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To authorize your requests, use environment automation client credentials and generate a JSON Web Token (JWT)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: To create client credentials, you must be an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/roles.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Organization Admin"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or Organization Owner."},"children":[]}]}]}]}],"sectionId":"/sai/content-items-api/section/authorization"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"section/authorization/create-an-automation-client"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create an automation client"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"In the Sitecore Cloud Portal, open SitecoreAI Deploy."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Click "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" > "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Environment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" > "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" > "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Automation"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fill out the automation client details, then click "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Copy the client ID and the client secret because you won't be able to view them again in SitecoreAI Deploy. You'll use them to request a JWT."},"children":[]}]}]}]}]}],"sectionId":"/sai/content-items-api/section/authorization/create-an-automation-client"}],"sectionId":"/sai/content-items-api/section/authorization/create-an-automation-client"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"section/authorization/request-a-jwt"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a JWT"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Run the following cURL command to request a JWT. Replace the placeholder values with your client ID and client secret."},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  curl -X POST 'https://auth.sitecorecloud.io/oauth/token' \\\n  --header 'Content-Type: application/x-www-form-urlencoded' \\\n  --data-urlencode 'client_id={YOUR_CLIENT_ID}' \\\n  --data-urlencode 'client_secret={YOUR_CLIENT_SECRET}' \\\n  --data-urlencode 'grant_type=client_credentials' \\\n  --data-urlencode 'audience=https://api.sitecorecloud.io'\n","language":"curl"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  curl -X POST 'https://auth.sitecorecloud.io/oauth/token' \\\n  --header 'Content-Type: application/x-www-form-urlencoded' \\\n  --data-urlencode 'client_id={YOUR_CLIENT_ID}' \\\n  --data-urlencode 'client_secret={YOUR_CLIENT_SECRET}' \\\n  --data-urlencode 'grant_type=client_credentials' \\\n  --data-urlencode 'audience=https://api.sitecorecloud.io'\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"In the response, the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"access_token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" key contains the JWT:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  {\n    \"access_token\": \"{YOUR_JWT}\",\n    \"scope\": \"xmcloud.cm:admin\",\n    \"expires_in\": 86400,\n    \"token_type\": \"Bearer\"\n  }\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  {\n    \"access_token\": \"{YOUR_JWT}\",\n    \"scope\": \"xmcloud.cm:admin\",\n    \"expires_in\": 86400,\n    \"token_type\": \"Bearer\"\n  }\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The JWT expires in 24 hours. If your requests unexpectedly return a response with status "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"401 Unauthorized"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", request a new JWT by repeating this "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" request."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"We recommend that you cache the JWT for 24 hours to avoid repeating this "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" request while the JWT is still valid."},"children":[]}]}]}]}],"sectionId":"/sai/content-items-api/section/authorization/request-a-jwt"}],"sectionId":"/sai/content-items-api/section/authorization/request-a-jwt"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"section/authorization/include-the-jwt-in-the-request-header"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Include the JWT in the request header"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can now start making REST API requests. You must include the JWT in the request header of every request. For example:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"curl -X GET '{YOUR_BASE_URL}/...' \\\n-H 'Authorization: Bearer {YOUR_JWT}' \\\n-H 'Accept: application/json'\n","language":"curl"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"curl -X GET '{YOUR_BASE_URL}/...' \\\n-H 'Authorization: Bearer {YOUR_JWT}' \\\n-H 'Accept: application/json'\n"},"children":[]}]}]}],"sectionId":"/sai/content-items-api/section/authorization/include-the-jwt-in-the-request-header"}],"sectionId":"/sai/content-items-api/section/authorization/include-the-jwt-in-the-request-header"}]}]}},{"type":"group","label":"Authorization","link":"/sai/content-items-api/section/authorization","routeSlug":"/sai/content-items-api/section/authorization","items":[{"type":"link","label":"Create an automation client","link":"/sai/content-items-api/section/authorization/create-an-automation-client","routeSlug":"/sai/content-items-api/section/authorization/create-an-automation-client","content":null},{"type":"link","label":"Request a JWT","link":"/sai/content-items-api/section/authorization/request-a-jwt","routeSlug":"/sai/content-items-api/section/authorization/request-a-jwt","content":null},{"type":"link","label":"Include the JWT in the request header","link":"/sai/content-items-api/section/authorization/include-the-jwt-in-the-request-header","routeSlug":"/sai/content-items-api/section/authorization/include-the-jwt-in-the-request-header","content":null}],"content":null},{"type":"group","label":"Content Items","link":"/sai/content-items-api/content-items","routeSlug":"/sai/content-items-api/content-items","items":[{"label":"Retrieve content item hierarchy children","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/content-items-api/content-items/retrievedatasourcehierarchychildren","routeSlug":"/sai/content-items-api/content-items/retrievedatasourcehierarchychildren","metadata":{"seo":{"title":"Retrieve content item hierarchy children","description":"Fetches a page of direct child items for a hierarchy node. Designed for user interfaces that display hierarchical content, such as tree pickers (controls that let users browse and select items by expanding and collapsing nodes), this endpoint lets you incrementally load large or deep hierarchies as users navigate them rather than retrieving the entire hierarchy in a single request."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"RetrieveDatasourceHierarchyChildren","name":"Retrieve content item hierarchy children","isWebhook":false,"pointer":"/paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve content item hierarchy children","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Fetches a page of direct child items for a hierarchy node. Designed for user interfaces that display hierarchical content, such as tree pickers (controls that let users browse and select items by expanding and collapsing nodes), this endpoint lets you incrementally load large or deep hierarchies as users navigate them rather than retrieving the entire hierarchy in a single request."},{"nodeType":"security","requirements":[{"schemes":[{"name":"Bearer","scopes":[],"type":"http","scheme":"Bearer","description":"Enter your bearer token in the text input below."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_1322","description":"The identifier of the hierarchy node (parent) whose children should be retrieved.","required":true,"example":"3875AC96-8ECF-44AE-8E25-851068B373CE"}],"pointer":"/paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"environmentId","in":"query","schemaId":"schema_1322","description":"The environment identifier. Defaults to \"main\". Currently only \"main\" is supported.","example":"main"},{"name":"language","in":"query","schemaId":"schema_1322","description":"The language code of the parent item for retrieving child item metadata. Defaults to \"en\".","example":"en"},{"name":"limit","in":"query","schemaId":"schema_1323","description":"The maximum number of children to return in a single page. Defaults to 50 when omitted.","example":50}],"pointer":"/paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-continuation","in":"header","schemaId":"schema_1322","description":"An optional opaque continuation token, returned from a previous call, used to fetch the next page of children.","example":"MXx8fDUw"}],"pointer":"/paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/content-items/{id}/hierarchy/children","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"3875AC96-8ECF-44AE-8E25-851068B373CE","schemaId":"schema_1322"}],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1322"},{"name":"language","in":"query","example":"en","schemaId":"schema_1322"},{"name":"limit","in":"query","example":50,"schemaId":"schema_1323"}],"querystring":[],"header":[{"name":"x-sc-continuation","in":"header","example":"MXx8fDUw","schemaId":"schema_1322"}],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"responseCodes":["200","400","401","404"],"pointer":"/api/v1/content-items/{id}/hierarchy/children","href":"content-items/retrievedatasourcehierarchychildren","openApiOperationId":"RetrieveDatasourceHierarchyChildren","summary":"Retrieve content item hierarchy children"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HierarchyChildrenResult"}},"schemaId":"components/schemas/HierarchyChildrenResult"},{"code":"400","description":"Invalid input format","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/responses/400/content/application~1json/example"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/responses/401/content/application~1json/example"]},{"code":"404","description":"Invalid content item ID","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/HierarchyChildrenResult","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HierarchyChildrenResult"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/responses/401/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/content-items/retrievedatasourcehierarchychildren"}],"panels":[]}]},"httpPath":"/api/v1/content-items/{id}/hierarchy/children"},{"label":"List content items","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/content-items-api/content-items/listdatasources","routeSlug":"/sai/content-items-api/content-items/listdatasources","metadata":{"seo":{"title":"List content items","description":"Returns a filtered list of content items. The list will include the content item specified by the contentItemId parameter and any content items below it in the hierarchy. If the content item has no children, it will just return the content item itself. The results can be filtered further by using the search parameter to filter the content items by name or other indexed fields, or the id parameter to fetch content items (up to 50) with matching ids. The search and id are mutually exclusive."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ListDatasources","name":"List content items","isWebhook":false,"pointer":"/paths/~1api~1v1~1content-items/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List content items","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns a filtered list of content items. The list will include the content item specified by the contentItemId parameter and any content items below it in the hierarchy. If the content item has no children, it will just return the content item itself. The results can be filtered further by using the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"search"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to filter the content items by name or other indexed fields, or the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to fetch content items (up to 50) with matching ids. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"search"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are mutually exclusive."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"Bearer","scopes":[],"type":"http","scheme":"Bearer","description":"Enter your bearer token in the text input below."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"environmentId","in":"query","schemaId":"schema_1322","description":"The environment identifier. Defaults to \"main\". Currently only \"main\" is supported.","example":"main"},{"name":"search","in":"query","schemaId":"schema_1322","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An optional search string used to filter content items by name or other indexed fields. Mutually exclusive with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"page"},{"name":"contentItemId","in":"query","schemaId":"schema_1322","description":"The identifier of the content item used to filter query results. If the content item has no children, the results will include just the content item itself. Otherwise, the results will include the content items and any others below it in the content hierarchy.","required":true,"example":"497f6eca-6276-4993-bfeb-53cbbbba6f08"},{"name":"language","in":"query","schemaId":"schema_1322","description":"The language of the content items","example":"en"},{"name":"pageSize","in":"query","schemaId":"schema_1323","description":"The maximum number of items to return in a single page.","example":10},{"name":"id","in":"query","schemaId":"schema_1324","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An optional list of known content item identifiers, e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id=id1&id=id2&id=id3"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Limited to 50 ids per request (extras truncated). Mutually exclusive with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"search"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"pointer":"/paths/~1api~1v1~1content-items/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-continuation","in":"header","schemaId":"schema_1322","description":"An optional opaque token returned from a previous call used to fetch the next page of results.","example":"MXx8fDEwMA=="}],"pointer":"/paths/~1api~1v1~1content-items/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/content-items","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1322"},{"name":"search","in":"query","example":"page","schemaId":"schema_1322"},{"name":"contentItemId","in":"query","required":true,"example":"497f6eca-6276-4993-bfeb-53cbbbba6f08","schemaId":"schema_1322"},{"name":"language","in":"query","example":"en","schemaId":"schema_1322"},{"name":"pageSize","in":"query","example":10,"schemaId":"schema_1323"},{"name":"id","in":"query","schemaId":"schema_1324"}],"querystring":[],"header":[{"name":"x-sc-continuation","in":"header","example":"MXx8fDEwMA==","schemaId":"schema_1322"}],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"responseCodes":["200","400","401","404"],"pointer":"/api/v1/content-items","href":"content-items/listdatasources","openApiOperationId":"ListDatasources","summary":"List content items"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation. Returns an empty result set if no content items match the query.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/DatasourceList"}},"schemaId":"components/schemas/DatasourceList"},{"code":"400","description":"Invalid input format, or both 'search' and 'id' supplied together","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items/get/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items/get/responses/400/content/application~1json/example"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items/get/responses/401/content/application~1json/example"]},{"code":"404","description":"The underlying search response was malformed or unavailable.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items/get/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items/get/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1content-items/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/DatasourceList","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/DatasourceList"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items/get/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items/get/responses/401/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items/get/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items/get/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/content-items/listdatasources"}],"panels":[]}]},"httpPath":"/api/v1/content-items"},{"label":"Create a content item","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/content-items-api/content-items/createdatasource","routeSlug":"/sai/content-items-api/content-items/createdatasource","metadata":{"seo":{"title":"Create a content item","description":"Creates a new content item under the specified parent, which is also a content item. Content items are instances of a content type (specified in this call by templateId)"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CreateDatasource","name":"Create a content item","isWebhook":false,"pointer":"/paths/~1api~1v1~1content-items/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a content item","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates a new content item under the specified parent, which is also a content item. Content items are instances of a content type (specified in this call by templateId)"},{"nodeType":"security","requirements":[{"schemes":[{"name":"Bearer","scopes":[],"type":"http","scheme":"Bearer","description":"Enter your bearer token in the text input below."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"environmentId","in":"query","schemaId":"schema_1322","description":"The environment identifier.","example":"main"}],"pointer":"/paths/~1api~1v1~1content-items/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json","text/json","application/*+json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateDatasourceInput"},"text/json":{"schemaId":"components/schemas/CreateDatasourceInput"},"application/*+json":{"schemaId":"components/schemas/CreateDatasourceInput"}},"schemaId":"components/schemas/CreateDatasourceInput","pointer":"/paths/~1api~1v1~1content-items/post/requestBody","description":"The creation input."}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/content-items","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1322"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateDatasourceInput"},"text/json":{"schemaId":"components/schemas/CreateDatasourceInput"},"application/*+json":{"schemaId":"components/schemas/CreateDatasourceInput"}},"responseCodes":["201","400","401"],"pointer":"/api/v1/content-items","href":"content-items/createdatasource","openApiOperationId":"CreateDatasource","summary":"Create a content item"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"schemaId":"components/schemas/CreateDatasourceInput","mediaTypes":["application/json","text/json","application/*+json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateDatasourceInput"},"text/json":{"schemaId":"components/schemas/CreateDatasourceInput"},"application/*+json":{"schemaId":"components/schemas/CreateDatasourceInput"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successful operation","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/DatasourceItem"}},"schemaId":"components/schemas/DatasourceItem"},{"code":"400","description":"Invalid input format","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items/post/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items/post/responses/400/content/application~1json/example"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items/post/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items/post/responses/401/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1content-items/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/DatasourceItem","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/DatasourceItem"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items/post/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items/post/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items/post/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items/post/responses/401/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/content-items/createdatasource"}],"panels":[]}]},"httpPath":"/api/v1/content-items"},{"label":"Retrieve a content item","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/content-items-api/content-items/retrievedatasourcewithfileds","routeSlug":"/sai/content-items-api/content-items/retrievedatasourcewithfileds","metadata":{"seo":{"title":"Retrieve a content item","description":"Fetches a content item by its identifier."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"RetrieveDatasourceWithFileds","name":"Retrieve a content item","isWebhook":false,"pointer":"/paths/~1api~1v1~1content-items~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a content item","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Fetches a content item by its identifier."},{"nodeType":"security","requirements":[{"schemes":[{"name":"Bearer","scopes":[],"type":"http","scheme":"Bearer","description":"Enter your bearer token in the text input below."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_1322","description":"The content item identifier.","required":true,"example":"76036f5e-cbce-46d1-af0a-4143f9b557aa"}],"pointer":"/paths/~1api~1v1~1content-items~1{id}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"environmentId","in":"query","schemaId":"schema_1322","description":"The environment identifier. Defaults to \"main\". Currently only \"main\" is supported.","example":"main"},{"name":"language","in":"query","schemaId":"schema_1322","description":"The language of the content item. Default value is \"en\".","example":"en"}],"pointer":"/paths/~1api~1v1~1content-items~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/content-items/{id}","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"76036f5e-cbce-46d1-af0a-4143f9b557aa","schemaId":"schema_1322"}],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1322"},{"name":"language","in":"query","example":"en","schemaId":"schema_1322"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"responseCodes":["200","400","401","404"],"pointer":"/api/v1/content-items/{id}","href":"content-items/retrievedatasourcewithfileds","openApiOperationId":"RetrieveDatasourceWithFileds","summary":"Retrieve a content item"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/DatasourceItem"}},"schemaId":"components/schemas/DatasourceItem"},{"code":"400","description":"Invalid input format","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/get/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/get/responses/400/content/application~1json/example"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/get/responses/401/content/application~1json/example"]},{"code":"404","description":"No content items search results found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/get/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/get/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1content-items~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/DatasourceItem","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/DatasourceItem"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/get/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/get/responses/401/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/get/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/get/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/content-items/retrievedatasourcewithfileds"}],"panels":[]}]},"httpPath":"/api/v1/content-items/{id}"},{"label":"Update a content item","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/content-items-api/content-items/updatedatasourceitem","routeSlug":"/sai/content-items-api/content-items/updatedatasourceitem","metadata":{"seo":{"title":"Update a content item","description":"Partially updates a content item. Only the properties and fields explicitly present in the request body are changed."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"UpdateDataSourceItem","name":"Update a content item","isWebhook":false,"pointer":"/paths/~1api~1v1~1content-items~1{id}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a content item","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Partially updates a content item. Only the properties and fields explicitly present in the request body are changed."},{"nodeType":"security","requirements":[{"schemes":[{"name":"Bearer","scopes":[],"type":"http","scheme":"Bearer","description":"Enter your bearer token in the text input below."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_1322","description":"The content item identifier.","required":true,"example":"76036f5e-cbce-46d1-af0a-4143f9b557aa"}],"pointer":"/paths/~1api~1v1~1content-items~1{id}/patch/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"environmentId","in":"query","schemaId":"schema_1322","description":"The environment identifier.","example":"main"}],"pointer":"/paths/~1api~1v1~1content-items~1{id}/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json","text/json","application/*+json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateDatasourceInput"},"text/json":{"schemaId":"components/schemas/UpdateDatasourceInput"},"application/*+json":{"schemaId":"components/schemas/UpdateDatasourceInput"}},"schemaId":"components/schemas/UpdateDatasourceInput","pointer":"/paths/~1api~1v1~1content-items~1{id}/patch/requestBody","description":"The partial update input."}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/api/v1/content-items/{id}","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"76036f5e-cbce-46d1-af0a-4143f9b557aa","schemaId":"schema_1322"}],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1322"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateDatasourceInput"},"text/json":{"schemaId":"components/schemas/UpdateDatasourceInput"},"application/*+json":{"schemaId":"components/schemas/UpdateDatasourceInput"}},"responseCodes":["200","400","401"],"pointer":"/api/v1/content-items/{id}","href":"content-items/updatedatasourceitem","openApiOperationId":"UpdateDataSourceItem","summary":"Update a content item"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"schemaId":"components/schemas/UpdateDatasourceInput","mediaTypes":["application/json","text/json","application/*+json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateDatasourceInput"},"text/json":{"schemaId":"components/schemas/UpdateDatasourceInput"},"application/*+json":{"schemaId":"components/schemas/UpdateDatasourceInput"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/DatasourceItem"}},"schemaId":"components/schemas/DatasourceItem"},{"code":"400","description":"Invalid input format","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/patch/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/patch/responses/400/content/application~1json/example"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/patch/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/patch/responses/401/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1content-items~1{id}/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/DatasourceItem","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/DatasourceItem"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/patch/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/patch/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/patch/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/patch/responses/401/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/content-items/updatedatasourceitem"}],"panels":[]}]},"httpPath":"/api/v1/content-items/{id}"},{"label":"Replace a content item","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/content-items-api/content-items/replacedatasource","routeSlug":"/sai/content-items-api/content-items/replacedatasource","metadata":{"seo":{"title":"Replace a content item","description":"Fully replaces a content item. Fields omitted from the request are cleared."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ReplaceDatasource","name":"Replace a content item","isWebhook":false,"pointer":"/paths/~1api~1v1~1content-items~1{id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Replace a content item","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Fully replaces a content item. Fields omitted from the request are cleared."},{"nodeType":"security","requirements":[{"schemes":[{"name":"Bearer","scopes":[],"type":"http","scheme":"Bearer","description":"Enter your bearer token in the text input below."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_1322","description":"The content item identifier.","required":true,"example":"76036f5e-cbce-46d1-af0a-4143f9b557aa"}],"pointer":"/paths/~1api~1v1~1content-items~1{id}/put/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"environmentId","in":"query","schemaId":"schema_1322","description":"The environment identifier.","example":"main"}],"pointer":"/paths/~1api~1v1~1content-items~1{id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json","text/json","application/*+json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ReplaceDatasourceInput"},"text/json":{"schemaId":"components/schemas/ReplaceDatasourceInput"},"application/*+json":{"schemaId":"components/schemas/ReplaceDatasourceInput"}},"schemaId":"components/schemas/ReplaceDatasourceInput","pointer":"/paths/~1api~1v1~1content-items~1{id}/put/requestBody","description":"The replacement input."}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v1/content-items/{id}","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"76036f5e-cbce-46d1-af0a-4143f9b557aa","schemaId":"schema_1322"}],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1322"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ReplaceDatasourceInput"},"text/json":{"schemaId":"components/schemas/ReplaceDatasourceInput"},"application/*+json":{"schemaId":"components/schemas/ReplaceDatasourceInput"}},"responseCodes":["200","400","401","404"],"pointer":"/api/v1/content-items/{id}","href":"content-items/replacedatasource","openApiOperationId":"ReplaceDatasource","summary":"Replace a content item"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"schemaId":"components/schemas/ReplaceDatasourceInput","mediaTypes":["application/json","text/json","application/*+json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ReplaceDatasourceInput"},"text/json":{"schemaId":"components/schemas/ReplaceDatasourceInput"},"application/*+json":{"schemaId":"components/schemas/ReplaceDatasourceInput"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/DatasourceItem"}},"schemaId":"components/schemas/DatasourceItem"},{"code":"400","description":"Invalid input format","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/put/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/put/responses/400/content/application~1json/example"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/put/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/put/responses/401/content/application~1json/example"]},{"code":"404","description":"Content item not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/put/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/put/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1content-items~1{id}/put/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/DatasourceItem","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/DatasourceItem"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/put/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/put/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/put/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/put/responses/401/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/put/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/put/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/content-items/replacedatasource"}],"panels":[]}]},"httpPath":"/api/v1/content-items/{id}"},{"label":"Delete a content item","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/content-items-api/content-items/deletedatasource","routeSlug":"/sai/content-items-api/content-items/deletedatasource","metadata":{"seo":{"title":"Delete a content item","description":"Deletes a content item. Use permanently=true to permanently remove it; otherwise the item is moved to the recycle bin."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"DeleteDatasource","name":"Delete a content item","isWebhook":false,"pointer":"/paths/~1api~1v1~1content-items~1{id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a content item","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deletes a content item. Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permanently=true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to permanently remove it; otherwise the item is moved to the recycle bin."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"Bearer","scopes":[],"type":"http","scheme":"Bearer","description":"Enter your bearer token in the text input below."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_1322","description":"The content item identifier.","required":true,"example":"76036f5e-cbce-46d1-af0a-4143f9b557aa"}],"pointer":"/paths/~1api~1v1~1content-items~1{id}/delete/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"environmentId","in":"query","schemaId":"schema_1322","description":"The environment identifier.","example":"main"},{"name":"permanently","in":"query","schemaId":"schema_1325","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the item is permanently deleted."},"children":[]}]}]}]}],"pointer":"/paths/~1api~1v1~1content-items~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v1/content-items/{id}","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"76036f5e-cbce-46d1-af0a-4143f9b557aa","schemaId":"schema_1322"}],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1322"},{"name":"permanently","in":"query","schemaId":"schema_1325"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"responseCodes":["204","401","404"],"pointer":"/api/v1/content-items/{id}","href":"content-items/deletedatasource","openApiOperationId":"DeleteDatasource","summary":"Delete a content item"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"Successful operation"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/delete/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/delete/responses/401/content/application~1json/example"]},{"code":"404","description":"Content item not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/delete/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/delete/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1content-items~1{id}/delete/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"204"},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/delete/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/delete/responses/401/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/delete/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}/delete/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/content-items/deletedatasource"}],"panels":[]}]},"httpPath":"/api/v1/content-items/{id}"},{"label":"Validate a content item","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/content-items-api/content-items/validatedatasource","routeSlug":"/sai/content-items-api/content-items/validatedatasource","metadata":{"seo":{"title":"Validate a content item","description":"Executes the validators assigned to the content item's fields against their persisted values and returns the results grouped by validation mode. Fields with no assigned validators are omitted. If a single validator fails to execute, its failure is captured as an error result for that validator only and does not prevent other validators from executing."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ValidateDatasource","name":"Validate a content item","isWebhook":false,"pointer":"/paths/~1api~1v1~1content-items~1{id}~1validate/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Validate a content item","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Executes the validators assigned to the content item's fields against their persisted values and returns the results grouped by validation mode. Fields with no assigned validators are omitted. If a single validator fails to execute, its failure is captured as an error result for that validator only and does not prevent other validators from executing."},{"nodeType":"security","requirements":[{"schemes":[{"name":"Bearer","scopes":[],"type":"http","scheme":"Bearer","description":"Enter your bearer token in the text input below."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_1322","description":"The content item identifier.","required":true,"example":"76036f5e-cbce-46d1-af0a-4143f9b557aa"}],"pointer":"/paths/~1api~1v1~1content-items~1{id}~1validate/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"environmentId","in":"query","schemaId":"schema_1322","description":"The environment identifier. Defaults to \"main\". Currently only \"main\" is supported.","example":"main"}],"pointer":"/paths/~1api~1v1~1content-items~1{id}~1validate/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/content-items/{id}/validate","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"76036f5e-cbce-46d1-af0a-4143f9b557aa","schemaId":"schema_1322"}],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1322"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"responseCodes":["200","400","401","404"],"pointer":"/api/v1/content-items/{id}/validate","href":"content-items/validatedatasource","openApiOperationId":"ValidateDatasource","summary":"Validate a content item"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContentValidationResult"}},"schemaId":"components/schemas/ContentValidationResult"},{"code":"400","description":"Invalid input format","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1validate/get/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1validate/get/responses/400/content/application~1json/example"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1validate/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1validate/get/responses/401/content/application~1json/example"]},{"code":"404","description":"Content item not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1validate/get/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1validate/get/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1content-items~1{id}~1validate/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ContentValidationResult","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContentValidationResult"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1validate/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1validate/get/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1validate/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1validate/get/responses/401/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1validate/get/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1validate/get/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/content-items/validatedatasource"}],"panels":[]}]},"httpPath":"/api/v1/content-items/{id}/validate"},{"label":"List live content items","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/content-items-api/content-items/listlivedatasources","routeSlug":"/sai/content-items-api/content-items/listlivedatasources","metadata":{"seo":{"title":"List live content items","description":"Fetches published content items by their identifiers from the Edge Delivery API."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ListLiveDatasources","name":"List live content items","isWebhook":false,"pointer":"/paths/~1api~1v1~1content-items~1live/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List live content items","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Fetches published content items by their identifiers from the Edge Delivery API."},{"nodeType":"security","requirements":[{"schemes":[{"name":"Bearer","scopes":[],"type":"http","scheme":"Bearer","description":"Enter your bearer token in the text input below."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"environmentId","in":"query","schemaId":"schema_1322","description":"The environment identifier. Defaults to \"main\". Currently only \"main\" is supported.","example":"main"}],"pointer":"/paths/~1api~1v1~1content-items~1live/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json","text/json","application/*+json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_1326"},"text/json":{"schemaId":"schema_1326"},"application/*+json":{"schemaId":"schema_1326"}},"schemaId":"schema_1326","pointer":"/paths/~1api~1v1~1content-items~1live/post/requestBody","description":"The request data."}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/content-items/live","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1322"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_1326"},"text/json":{"schemaId":"schema_1326"},"application/*+json":{"schemaId":"schema_1326"}},"responseCodes":["200","400"],"pointer":"/api/v1/content-items/live","href":"content-items/listlivedatasources","openApiOperationId":"ListLiveDatasources","summary":"List live content items"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"schemaId":"schema_1326","mediaTypes":["application/json","text/json","application/*+json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_1326"},"text/json":{"schemaId":"schema_1326"},"application/*+json":{"schemaId":"schema_1326"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1327"}},"schemaId":"schema_1327"},{"code":"400","description":"Invalid input format","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1live/post/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1live/post/responses/400/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1content-items~1live/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1327","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1327"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1live/post/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1live/post/responses/400/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/content-items/listlivedatasources"}],"panels":[]}]},"httpPath":"/api/v1/content-items/live"},{"label":"Retrieve content item hierarchy","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/content-items-api/content-items/retrievedatasource","routeSlug":"/sai/content-items-api/content-items/retrievedatasource","metadata":{"seo":{"title":"Retrieve content item hierarchy","description":"Fetches the tree structure of a content item, its parents, or its children. Use this endpoint when you know the identifier of the root item, for example, if you want to fetch the structure of a treelist field with a defined content item source."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"RetrieveDatasource","name":"Retrieve content item hierarchy","isWebhook":false,"pointer":"/paths/~1api~1v1~1content-items~1{contentItemId}~1hierarchy/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve content item hierarchy","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Fetches the tree structure of a content item, its parents, or its children. Use this endpoint when you know the identifier of the root item, for example, if you want to fetch the structure of a treelist field with a defined content item source."},{"nodeType":"security","requirements":[{"schemes":[{"name":"Bearer","scopes":[],"type":"http","scheme":"Bearer","description":"Enter your bearer token in the text input below."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"contentItemId","in":"path","schemaId":"schema_1322","description":"The identifier of the content item root item.","required":true,"example":"3875AC96-8ECF-44AE-8E25-851068B373CE"}],"pointer":"/paths/~1api~1v1~1content-items~1{contentItemId}~1hierarchy/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"ChildrenModelIds","in":"query","schemaId":"schema_1328","description":"Identifiers of the child content types (base templates). Only child content items of the content types specified by these ids will be returned.","example":["4cf51e95-ee7e-4ad6-a69f-e4d740b03616","d9584f11-07d3-4cda-8373-7f97ceedbc09"]},{"name":"Language","in":"query","schemaId":"schema_1329","description":"The language of the content items","example":"en"},{"name":"environmentId","in":"query","schemaId":"schema_1322","description":"The environment identifier. Defaults to \"main\". Currently only \"main\" is supported.","example":"main"}],"pointer":"/paths/~1api~1v1~1content-items~1{contentItemId}~1hierarchy/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/content-items/{contentItemId}/hierarchy","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[{"name":"contentItemId","in":"path","required":true,"example":"3875AC96-8ECF-44AE-8E25-851068B373CE","schemaId":"schema_1322"}],"query":[{"name":"ChildrenModelIds","in":"query","example":["4cf51e95-ee7e-4ad6-a69f-e4d740b03616","d9584f11-07d3-4cda-8373-7f97ceedbc09"],"schemaId":"schema_1328"},{"name":"Language","in":"query","example":"en","schemaId":"schema_1329"},{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1322"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"responseCodes":["200","400","404"],"pointer":"/api/v1/content-items/{contentItemId}/hierarchy","href":"content-items/retrievedatasource","openApiOperationId":"RetrieveDatasource","summary":"Retrieve content item hierarchy"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HierarchyItem"}},"schemaId":"components/schemas/HierarchyItem"},{"code":"400","description":"Invalid input format","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{contentItemId}~1hierarchy/get/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{contentItemId}~1hierarchy/get/responses/400/content/application~1json/example"]},{"code":"404","description":"Invalid content item ID","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{contentItemId}~1hierarchy/get/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{contentItemId}~1hierarchy/get/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1content-items~1{contentItemId}~1hierarchy/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/HierarchyItem","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HierarchyItem"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{contentItemId}~1hierarchy/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{contentItemId}~1hierarchy/get/responses/400/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{contentItemId}~1hierarchy/get/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{contentItemId}~1hierarchy/get/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/content-items/retrievedatasource"}],"panels":[]}]},"httpPath":"/api/v1/content-items/{contentItemId}/hierarchy"},{"label":"Translate a content item.","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/content-items-api/content-items/translatedatasource","routeSlug":"/sai/content-items-api/content-items/translatedatasource","metadata":{"seo":{"title":"Translate a content item.","description":"Starts translation for a content item and returns a job handle. There are three translation strategies: 0 - skip translation if the content already exists in the target language, 1 - add a new version in the target language, and 2 - add a new version in the target language and reset the workflow."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"TranslateDatasource","name":"Translate a content item.","isWebhook":false,"pointer":"/paths/~1api~1v1~1content-items~1{id}~1translate/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Translate a content item.","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Starts translation for a content item and returns a job handle. There are three translation strategies: 0 - skip translation if the content already exists in the target language, 1 - add a new version in the target language, and 2 - add a new version in the target language and reset the workflow."},{"nodeType":"security","requirements":[{"schemes":[{"name":"Bearer","scopes":[],"type":"http","scheme":"Bearer","description":"Enter your bearer token in the text input below."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_1322","description":"The content item identifier.","required":true,"example":"76036f5e-cbce-46d1-af0a-4143f9b557aa"}],"pointer":"/paths/~1api~1v1~1content-items~1{id}~1translate/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json","text/json","application/*+json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BaseTranslationInput"},"text/json":{"schemaId":"components/schemas/BaseTranslationInput"},"application/*+json":{"schemaId":"components/schemas/BaseTranslationInput"}},"schemaId":"components/schemas/BaseTranslationInput","pointer":"/paths/~1api~1v1~1content-items~1{id}~1translate/post/requestBody","description":"Translation request input."}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/content-items/{id}/translate","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"76036f5e-cbce-46d1-af0a-4143f9b557aa","schemaId":"schema_1322"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/BaseTranslationInput"},"text/json":{"schemaId":"components/schemas/BaseTranslationInput"},"application/*+json":{"schemaId":"components/schemas/BaseTranslationInput"}},"responseCodes":["200","400","401"],"pointer":"/api/v1/content-items/{id}/translate","href":"content-items/translatedatasource","openApiOperationId":"TranslateDatasource","summary":"Translate a content item."},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"schemaId":"components/schemas/BaseTranslationInput","mediaTypes":["application/json","text/json","application/*+json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BaseTranslationInput"},"text/json":{"schemaId":"components/schemas/BaseTranslationInput"},"application/*+json":{"schemaId":"components/schemas/BaseTranslationInput"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/JobResponse"}},"schemaId":"components/schemas/JobResponse"},{"code":"400","description":"Invalid input format","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1translate/post/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1translate/post/responses/400/content/application~1json/example"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1translate/post/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1translate/post/responses/401/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1content-items~1{id}~1translate/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/JobResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/JobResponse"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1translate/post/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1translate/post/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1translate/post/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1content-items~1{id}~1translate/post/responses/401/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/content-items/translatedatasource"}],"panels":[]}]},"httpPath":"/api/v1/content-items/{id}/translate"}],"content":{"contentType":"group","meta":{"name":"Content Items"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Content Items","showPageActions":true},{"nodeType":"markdoc","content":"The Content Items API lets you manage content items for an environment."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v1/content-items/{id}/hierarchy/children","summary":"Retrieve content item hierarchy children","prefix":{"name":"get","color":"get"},"badges":[],"link":"/content-items/retrievedatasourcehierarchychildren","deprecated":false},{"title":"/api/v1/content-items","summary":"List content items","prefix":{"name":"get","color":"get"},"badges":[],"link":"/content-items/listdatasources","deprecated":false},{"title":"/api/v1/content-items","summary":"Create a content item","prefix":{"name":"post","color":"post"},"badges":[],"link":"/content-items/createdatasource","deprecated":false},{"title":"/api/v1/content-items/{id}","summary":"Retrieve a content item","prefix":{"name":"get","color":"get"},"badges":[],"link":"/content-items/retrievedatasourcewithfileds","deprecated":false},{"title":"/api/v1/content-items/{id}","summary":"Update a content item","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/content-items/updatedatasourceitem","deprecated":false},{"title":"/api/v1/content-items/{id}","summary":"Replace a content item","prefix":{"name":"put","color":"put"},"badges":[],"link":"/content-items/replacedatasource","deprecated":false},{"title":"/api/v1/content-items/{id}","summary":"Delete a content item","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/content-items/deletedatasource","deprecated":false},{"title":"/api/v1/content-items/{id}/validate","summary":"Validate a content item","prefix":{"name":"get","color":"get"},"badges":[],"link":"/content-items/validatedatasource","deprecated":false},{"title":"/api/v1/content-items/live","summary":"List live content items","prefix":{"name":"post","color":"post"},"badges":[],"link":"/content-items/listlivedatasources","deprecated":false},{"title":"/api/v1/content-items/{contentItemId}/hierarchy","summary":"Retrieve content item hierarchy","prefix":{"name":"get","color":"get"},"badges":[],"link":"/content-items/retrievedatasource","deprecated":false},{"title":"/api/v1/content-items/{id}/translate","summary":"Translate a content item.","prefix":{"name":"post","color":"post"},"badges":[],"link":"/content-items/translatedatasource","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/BaseContentModel":{"id":"components/schemas/BaseContentModel","kind":"json-schema","title":"BaseContentModel","data":{"type":"object","properties":{"id":{"type":"string","description":"The content type identifier","nullable":true,"example":"d4e5f6a7-b8c9-0123-4567-89abcdef0123"},"name":{"type":"string","description":"The content type name.","nullable":true,"example":"Promo"},"created":{"type":"string","description":"The content type creation date.","nullable":true,"example":"2024-01-01T12:00:00Z"},"createdBy":{"type":"string","description":"The content type author.","nullable":true,"example":"sitecore\\admin"},"updated":{"type":"string","description":"The content type last update date.","nullable":true,"example":"2024-01-02T12:00:00Z"},"updatedBy":{"type":"string","description":"The author of the last update to the content type.","nullable":true,"example":"sitecore\\admin"}},"additionalProperties":false,"description":"Simplified representation of a content type."}},"components/schemas/BaseTranslationInput":{"id":"components/schemas/BaseTranslationInput","kind":"json-schema","title":"BaseTranslationInput","data":{"required":["sourceLanguage","targetLanguage"],"type":"object","properties":{"sourceLanguage":{"minLength":1,"type":"string","description":"Source language for translation.","example":"en"},"targetLanguage":{"minLength":1,"type":"string","description":"Target language for translation.","example":"jp"},"translationStrategy":{"$ref":"#/components/schemas/TranslationStrategy"}},"additionalProperties":false}},"components/schemas/CDN":{"id":"components/schemas/CDN","kind":"json-schema","title":"CDN","data":{"type":"object","properties":{"availabilityDate":{"type":"string","description":"The availability date.","format":"date-time","nullable":true,"example":"2024-06-01T00:00:00Z"},"unavailabilityDate":{"type":"string","description":"The unavailability date.","format":"date-time","nullable":true,"example":"2024-06-01T00:00:00Z"},"onDemandAvailability":{"type":"boolean","description":"Indicates whether the content item is currently available on demand.","nullable":true,"example":true}},"additionalProperties":false,"description":"Represents the CDN information for a live content item."}},"components/schemas/ComponentItemField":{"id":"components/schemas/ComponentItemField","kind":"json-schema","title":"ComponentItemField","data":{"type":"object","properties":{"id":{"type":"string","description":"The field identifier.","nullable":true,"example":"37265ed7-85cf-4876-9c09-b6590fc6cf3a"},"name":{"type":"string","description":"The field name.","nullable":true,"example":"Title"},"type":{"type":"string","description":"The field type.","nullable":true,"example":"Single-Line Text"},"displayName":{"type":"string","description":"The field display name.","nullable":true,"example":"Display Name"},"value":{"$ref":"#/components/schemas/IFieldValue"},"access":{"$ref":"#/components/schemas/ItemFieldAccess"},"label":{"type":"string","description":"The field label.","nullable":true,"example":"Page Title"},"containsStandardValue":{"type":"boolean","description":"Whether field contains standard value.","example":false},"containsFallbackValue":{"type":"boolean","description":"Whether field contains fallback value.","example":false}},"additionalProperties":false,"description":"The component item field model."}},"components/schemas/ContentValidationResult":{"id":"components/schemas/ContentValidationResult","kind":"json-schema","title":"ContentValidationResult","data":{"type":"object","properties":{"id":{"type":"string","nullable":true,"description":"The content item identifier.","example":"3875AC96-8ECF-44AE-8E25-851068B373CE"},"groups":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Field validation results grouped by validation mode (for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ValidatorBar"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"FieldRegexValidation"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Fields with no assigned validators are omitted."},"children":[]}]}]}],"additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/FieldValidationResult"}},"nullable":true}},"additionalProperties":false}},"components/schemas/CreateDatasourceInput":{"id":"components/schemas/CreateDatasourceInput","kind":"json-schema","title":"CreateDatasourceInput","data":{"required":["name","parentId","templateId"],"type":"object","properties":{"name":{"minLength":1,"type":"string","description":"The content item name. ","example":"MyContentItem"},"displayName":{"type":"string","description":"The content item display name.","nullable":true,"example":"My Content Item"},"parentId":{"minLength":1,"type":"string","description":"The identifier of the content item that is the parent of the new content item.","example":"{110D559F-DEA5-42EA-9C1C-8A5DF7E70EF9}"},"templateId":{"minLength":1,"type":"string","description":"The content type identifier.","example":"{76036F5E-CBCE-46D1-AF0A-4143F9B557AA}"},"language":{"type":"string","description":"The content item language.","nullable":true,"example":"en"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/UpdateFieldValue"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The content item field values. Each field's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must match a field defined on the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"TemplateId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and can be found by calling the Retrieve a Content Type endpoint in the Content Types API. When null or empty, the item is created with no field values."},"children":[]}]}]}],"nullable":true}},"additionalProperties":false,"description":"Input model for creating a new content item."}},"components/schemas/DatasourceItem":{"id":"components/schemas/DatasourceItem","kind":"json-schema","title":"DatasourceItem","data":{"type":"object","properties":{"isFallback":{"type":"boolean","description":"Indicates whether any item-level fallback was used for the response.","example":true},"revision":{"type":"string","description":"Unique revision identifier for the content item. Used as an optimistic concurrency guard during save or update operations. \nThe value is updated whenever the item changes, allowing clients to verify that they are updating the latest revision.","nullable":true,"example":"37265ed7-85cf-4876-9c09-b6590fc6cf3a"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/ComponentItemField"},"description":"The content item fields.","nullable":true},"id":{"type":"string","nullable":true,"description":"The content item identifier.","example":"37265ed7-85cf-4876-9c09-b6590fc6cf3a"},"name":{"type":"string","nullable":true,"description":"The content item name.","example":"My content item"},"displayName":{"type":"string","nullable":true,"description":"The content item display name.","example":"My content item"},"language":{"type":"string","nullable":true,"description":"The content item language.","example":"en"},"version":{"type":"integer","format":"int32","description":"The content item version.","example":1},"templateId":{"type":"string","nullable":true,"description":"The  template identifier.","example":"97265ed7-85cf-4876-9c09-b6590fc6cf3a"},"path":{"type":"string","nullable":true,"description":"The content item path.","example":"/sitecore/content/Home"},"permissions":{"$ref":"#/components/schemas/Permissions"},"system":{"$ref":"#/components/schemas/System"}},"additionalProperties":false,"description":"The content item model."}},"components/schemas/DatasourceList":{"id":"components/schemas/DatasourceList","kind":"json-schema","title":"DatasourceList","data":{"type":"object","properties":{"count":{"type":"integer","description":"Total number of matching content items.","format":"int32","example":10},"next":{"type":"string","description":"Continuation token.","nullable":true,"example":"token-from-previous-response"},"results":{"type":"array","items":{"$ref":"#/components/schemas/DatasourceSearchItem"},"description":"List of content item search results.","nullable":true}},"additionalProperties":false,"description":"The content item list model."}},"components/schemas/DatasourceSearchItem":{"id":"components/schemas/DatasourceSearchItem","kind":"json-schema","title":"DatasourceSearchItem","data":{"type":"object","properties":{"name":{"type":"string","description":"The name of the item.","nullable":true,"example":"Home"},"displayName":{"type":"string","description":"The display name of the item.","nullable":true,"example":"Home Page"},"itemId":{"type":"string","description":"The unique identifier of the item.","nullable":true,"example":"37265ed7-85cf-4876-9c09-b6590fc6cf3a"},"path":{"type":"string","description":"The full path of the item in the content tree.","nullable":true,"example":"/sitecore/content/Home"},"version":{"type":"integer","description":"The version number of the item.","format":"int32","example":1},"language":{"type":"string","description":"The language of the item.","nullable":true,"example":"en"},"templateId":{"type":"string","description":"The template identifier of the item.","nullable":true,"example":"97265ed7-85cf-4876-9c09-b6590fc6cf3a"},"baseContentModels":{"type":"array","items":{"type":"string"},"description":"The collection of base content model names associated with the item.","nullable":true,"example":["ContentModelA","ContentModelB"]},"created":{"type":"string","description":"The date and time the item was created.","nullable":true,"example":"2024-01-15T10:30:00Z"},"createdBy":{"type":"string","description":"The name of the user who created the item.","nullable":true,"example":"sitecore\\admin"},"updated":{"type":"string","description":"The date and time the item was last updated.","nullable":true,"example":"2024-02-20T14:45:00Z"},"updatedBy":{"type":"string","description":"The name of the user who last updated the item.","nullable":true,"example":"sitecore\\admin"}},"additionalProperties":false,"description":"Response for content item search results."}},"components/schemas/FieldValidationResult":{"id":"components/schemas/FieldValidationResult","kind":"json-schema","title":"FieldValidationResult","data":{"type":"object","properties":{"fieldId":{"type":"string","nullable":true,"description":"The field identifier.","example":"59D4EE10-627C-4FD3-A964-61A88B092CB"},"fieldName":{"type":"string","nullable":true,"description":"The field name.","example":"Page Title"},"results":{"type":"array","items":{"$ref":"#/components/schemas/FieldValidationRuleResult"},"nullable":true}},"additionalProperties":false}},"components/schemas/FieldValidationRuleResult":{"id":"components/schemas/FieldValidationRuleResult","kind":"json-schema","title":"FieldValidationRuleResult","data":{"type":"object","properties":{"ruleId":{"type":"string","nullable":true,"description":"The validation rule identifier.","example":"59D4EE10-627C-4FD3-A964-61A88B092CB"},"ruleName":{"type":"string","nullable":true,"description":"The validation rule name.","example":"Required Field"},"mode":{"type":"string","nullable":true,"description":"The validation mode used to group results for UI rendering (for example ValidatorBar, FieldRegexValidation).","example":"FieldRegexValidation"},"valid":{"type":"boolean","description":"Indicates whether the field value passed the validator.","example":true},"message":{"type":"string","nullable":true,"description":"The validator message, if any.","example":"The field value is required."},"severity":{"type":"string","nullable":true,"description":"The validator severity (for example Error, Warning, Suggestion). Also used to represent validator execution failures.","example":"Warning"}},"additionalProperties":false}},"components/schemas/HierarchyChildItem":{"id":"components/schemas/HierarchyChildItem","kind":"json-schema","title":"HierarchyChildItem","data":{"type":"object","properties":{"hasPresentation":{"type":"boolean","description":"Whether the content item has presentation details. An item with presentation is an item with a layout assigned.","example":true},"hasChildren":{"type":"boolean","description":"Whether the content item has any child items. Used by clients to render expand/collapse controls\nwithout issuing an additional request.","example":true},"contentModelName":{"type":"string","description":"The content type (data template) name.","nullable":true,"example":"Product"},"id":{"type":"string","nullable":true,"description":"The content item identifier.","example":"3875AC96-8ECF-44AE-8E25-851068B373CE"},"name":{"type":"string","nullable":true,"description":"The content item name.","example":"My content item"},"displayName":{"type":"string","nullable":true,"description":"The content item display name.","example":"My content item"},"language":{"type":"string","nullable":true,"description":"The content item language.","example":"en"},"version":{"type":"integer","format":"int32","description":"The content item version.","example":1},"templateId":{"type":"string","nullable":true,"description":"The template identifier.","example":"97265ed7-85cf-4876-9c09-b6590fc6cf3a"},"path":{"type":"string","nullable":true,"description":"The content item path.","example":"/sitecore/content/"},"permissions":{"$ref":"#/components/schemas/Permissions"},"system":{"$ref":"#/components/schemas/System"}},"additionalProperties":false,"description":"Represents a single child node returned by the hierarchy children (lazy-loading) endpoint."}},"components/schemas/HierarchyChildrenResult":{"id":"components/schemas/HierarchyChildrenResult","kind":"json-schema","title":"HierarchyChildrenResult","data":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/HierarchyChildItem"},"description":"The children found on this page.","nullable":true},"continuationToken":{"type":"string","description":"An opaque continuation token used to fetch the next page of children. Null when there\nare no additional pages remaining.","nullable":true,"example":"MXx8fDUw"}},"additionalProperties":false,"description":"Represents a single page of children for a hierarchy node, used for lazy-loading tree picker scenarios."}},"components/schemas/HierarchyItem":{"id":"components/schemas/HierarchyItem","kind":"json-schema","title":"HierarchyItem","data":{"type":"object","properties":{"hasChildren":{"type":"boolean","description":"Whether the content item has any child pages.","example":true},"hasPresentation":{"type":"boolean","description":"Whether the content item has presentation. An item with presentation is an item with a layout assigned.","example":true},"children":{"type":"array","items":{"$ref":"#/components/schemas/HierarchyItem"},"description":"Child content items, represented as \"HierarchyItem\" objects. Each object has the same structure as the root content item in the response.","nullable":true,"example":[{"hasChildren":false,"hasPresentation":false,"children":null,"ancestors":null,"insertOptions":null,"baseContentModels":null,"id":"059a5e63-6fca-44ea-be8b-e0b7919895f6","name":"My item","displayName":"Home","language":"en","version":0,"templateId":"76036f5e-cbce-46d1-af0a-4143f9b557aa","path":"/sitecore/content/Home/item","permissions":{},"system":{}}]},"ancestors":{"type":"array","items":{"$ref":"#/components/schemas/HierarchyItem"},"description":"Ancestor content items, represented as \"HierarchyItem\" objects. Each object has the same structure as the root content item in the response.","nullable":true,"example":[{"hasChildren":true,"hasPresentation":false,"children":null,"ancestors":null,"baseContentModels":["1930bbeb7805471aa3be4858ac7cf696"],"id":"3875AC96-8ECF-44AE-8E25-851068B373CE","insertOptions":null,"name":"sitecore","displayName":"sitecore","language":"en","version":1,"templateId":"c6576836-910c-4a3d-ba03-c277dbd3b827","path":"/sitecore","permissions":{},"system":{}}]},"insertOptions":{"type":"array","items":{"$ref":"#/components/schemas/BaseContentModel"},"description":"Insert options of the content item. Insert options control which types of new items can be created beneath a specific item in the content tree.","nullable":true},"baseContentModels":{"type":"array","items":{"type":"string"},"description":"Base content type IDs of the content item.","nullable":true},"id":{"type":"string","nullable":true,"description":"The content item identifier.","example":"37265ed7-85cf-4876-9c09-b6590fc6cf3a"},"name":{"type":"string","nullable":true,"description":"The content item name.","example":"My content item"},"displayName":{"type":"string","nullable":true,"description":"The content item display name.","example":"My content item display name"},"language":{"type":"string","nullable":true,"description":"The content item language.","example":"en"},"version":{"type":"integer","format":"int32","description":"The content item version.","example":1},"templateId":{"type":"string","nullable":true,"description":"The template identifier.","example":"97265ed7-85cf-4876-9c09-b6590fc6cf3a"},"path":{"type":"string","nullable":true,"description":"The content item path","example":"/sitecore/content/Home"},"permissions":{"$ref":"#/components/schemas/Permissions"},"system":{"$ref":"#/components/schemas/System"}},"additionalProperties":false,"description":"The hierarchy item model."}},"components/schemas/IFieldValue":{"id":"components/schemas/IFieldValue","kind":"json-schema","title":"IFieldValue","data":{"type":"object","properties":{"text":{"type":"string","nullable":true,"description":"The text value.","example":"Sample content"},"displayName":{"type":"string","nullable":true,"description":"The file display name.","example":"Brochure"},"name":{"type":"string","nullable":true,"description":"The file  name.","example":"brochure.pdf"},"extension":{"type":"string","nullable":true,"description":"The file  extension.","example":"pdf"},"size":{"type":"integer","format":"int64","nullable":true,"description":"The file size in bytes.","example":120345},"id":{"type":"string","nullable":true,"description":"The file item identifier.","example":"4B9A6BAE-6B8D-4D72-BE0E-0BA769A8C24"},"src":{"type":"string","nullable":true,"description":"The image source URL.","example":"https://xmc.sitecore-staging.cloud/-/media/Project/sites/sample/image.jpeg"},"alt":{"type":"string","nullable":true,"description":"The image alt text.","example":"Sample image"},"width":{"type":"string","nullable":true,"description":"The image width.","example":"800"},"height":{"type":"string","nullable":true,"description":"The image height.","example":"600"},"mediaId":{"type":"string","nullable":true,"description":"The media item identifier.","example":"8B53C9A7-2E80-4B35-B61D-33D7D8D4E24B"},"href":{"type":"string","nullable":true,"description":"The link URL.","example":"https://xmc.sitecore-staging.cloud/en/sitecore/shell/sites/sample/Home/About"},"title":{"type":"string","nullable":true,"description":"The link title.","example":"About"},"type":{"type":"string","nullable":true,"description":"The link type.","example":"internal"},"attributes":{"type":"object","additionalProperties":{"type":"string"},"nullable":true,"description":"Additional link attributes.","example":{"target":"_blank","class":"my-css-class"}},"references":{"type":"array","items":{"$ref":"#/components/schemas/ReferenceElement"},"nullable":true}},"additionalProperties":false}},"components/schemas/ItemFieldAccess":{"id":"components/schemas/ItemFieldAccess","kind":"json-schema","title":"ItemFieldAccess","data":{"type":"object","properties":{"canRead":{"type":"boolean","description":"Can Read."},"canWrite":{"type":"boolean","description":"Can Write."}},"additionalProperties":false,"description":"The item field access permissions model."}},"components/schemas/JobResponse":{"id":"components/schemas/JobResponse","kind":"json-schema","title":"JobResponse","data":{"type":"object","properties":{"handle":{"type":"string","description":"The handle of the job.","nullable":true,"example":"job-handle-1"}},"additionalProperties":false}},"components/schemas/LiveDatasource":{"id":"components/schemas/LiveDatasource","kind":"json-schema","title":"LiveDatasource","data":{"type":"object","properties":{"id":{"type":"string","description":"The identifier of the content item.","nullable":true,"example":"110d559f-dea5-42ea-9c1c-8a5df7e70ef9"},"name":{"type":"string","description":"The name of the content item.","nullable":true,"example":"My Content Item"},"displayName":{"type":"string","description":"The display name of the content item.","nullable":true,"example":"My Content Item Display Name"},"path":{"type":"string","description":"The path of the content item.","nullable":true,"example":"/sitecore/content/MySite/Data/MyContentItem"},"language":{"type":"string","description":"The language of the content item.","nullable":true,"example":"en"},"version":{"type":"integer","description":"The version number of the content item.","format":"int32","example":1},"cdn":{"$ref":"#/components/schemas/CDN"}},"additionalProperties":false,"description":"Represents a published content item retrieved from the Edge Delivery API."}},"components/schemas/LiveDatasourceRequest":{"id":"components/schemas/LiveDatasourceRequest","kind":"json-schema","title":"LiveDatasourceRequest","data":{"required":["id","language"],"type":"object","properties":{"id":{"minLength":1,"type":"string","description":"The content item identifier.","example":"8f0b81bc-7388-46be-b109-6e73d1114470"},"language":{"minLength":1,"type":"string","description":"The language of the content item.","example":"en-US"}},"additionalProperties":false,"description":"Represents a request for live content item data."}},"components/schemas/Permissions":{"id":"components/schemas/Permissions","kind":"json-schema","title":"Permissions","data":{"type":"object","properties":{"canAdmin":{"type":"boolean","description":"Whether the current user has admin rights","example":true},"canWrite":{"type":"boolean","description":"Whether the current user has permissions to edit values","example":true},"canCreate":{"type":"boolean","description":"Whether the current user has permissions to create entities","example":true},"canDelete":{"type":"boolean","description":"Whether the current user has permissions to delete entities","example":true},"canRename":{"type":"boolean","description":"Whether the current user has permissions to rename  entities","example":true},"canRead":{"type":"boolean","description":"Whether the current user has permissions to see  entities","example":true},"canPublish":{"type":"boolean","description":"Whether the current user has permissions to publish sites in this environment","example":true},"canDuplicate":{"type":"boolean","description":"Whether the current user has permissions to duplicate entities","example":true},"canWriteLanguage":{"type":"boolean","description":"Whether the current user has permissions to write item language entities","example":true}},"additionalProperties":false,"description":" The access rights of the current user to the site."}},"components/schemas/ProblemDetails":{"id":"components/schemas/ProblemDetails","kind":"json-schema","title":"ProblemDetails","data":{"type":"object","properties":{"type":{"type":"string","description":"The type of the error response entity.","nullable":true},"title":{"type":"string","description":"The title of the error response entity.","nullable":true},"status":{"type":"integer","description":"The response status code.","format":"int32","nullable":true},"detail":{"type":"string","description":"A detailed explanation, specific to this occurrence of the problem.","nullable":true},"instance":{"type":"string","description":"If available, a URI reference that identifies the specific occurrence of the problem.","nullable":true}},"additionalProperties":{"description":"Any additional optional properties that describe the error(s)."}}},"components/schemas/ReferenceElement":{"id":"components/schemas/ReferenceElement","kind":"json-schema","title":"ReferenceElement","data":{"type":"object","description":"The referenced items.","properties":{"id":{"type":"string","nullable":true,"description":"The referenced item id","example":"{110D559A-CA9C-4B4C-8F31-DF8A0E6F447D}"},"name":{"type":"string","nullable":true,"description":"The referenced item name","example":"home"},"displayName":{"type":"string","nullable":true,"description":"The referenced item display name","example":"Home"}},"additionalProperties":false}},"components/schemas/ReplaceDatasourceInput":{"id":"components/schemas/ReplaceDatasourceInput","kind":"json-schema","title":"ReplaceDatasourceInput","data":{"required":["fields","name"],"type":"object","properties":{"name":{"minLength":1,"type":"string","description":"The content item name.","example":"MyContentItem"},"displayName":{"type":"string","description":"The content item display name.","nullable":true,"example":"My Content Item"},"language":{"type":"string","description":"The content item language.","nullable":true,"example":"en"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/UpdateFieldValue"},"description":"The complete set of field values for the content item.\nFields present in the current item but omitted here are cleared (set to empty value).\nThe service resolves each field's type from the content type before serialization."}},"additionalProperties":false,"description":"Input model for a full replacement (PUT) of a content item.\nFields omitted from Sitecore.XmApps.Components.Inputs.ReplaceDatasourceInput.Fields are cleared (set to empty)."}},"components/schemas/System":{"id":"components/schemas/System","kind":"json-schema","title":"System","data":{"type":"object","properties":{"created":{"type":"string","nullable":true,"description":"The creation time.","example":"2024-01-15T10:30:00Z"},"createdBy":{"type":"string","nullable":true,"description":"The creator.","example":"sitecore admin"},"updated":{"type":"string","nullable":true,"description":"The last updating time.","example":"2024-01-15T10:30:00Z"},"updatedBy":{"type":"string","nullable":true,"description":"The last updater.","example":"sitecore admin"}},"additionalProperties":false}},"components/schemas/TranslationStrategy":{"id":"components/schemas/TranslationStrategy","kind":"json-schema","title":"TranslationStrategy","data":{"enum":[0,1,2],"type":"integer","format":"int32","description":"Translation strategy to be used."}},"components/schemas/UpdateDatasourceInput":{"id":"components/schemas/UpdateDatasourceInput","kind":"json-schema","title":"UpdateDatasourceInput","data":{"type":"object","properties":{"name":{"type":"string","description":"The content item name.\nWhen supplied and different from the current name, the item is renamed.","nullable":true,"example":"MyContentItem"},"displayName":{"type":"string","description":"The content item display name.","nullable":true,"example":"My Content Item"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/UpdateFieldValue"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The content item field values. Each field's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must match a field defined on the template (content type). This can be found by calling the Retrieve a Content Type endpoint in the Content Types API. When null or empty, existing field values are left unchanged and will not be updated."},"children":[]}]}]}],"nullable":true}},"additionalProperties":false,"description":"Input model for a partial update (PATCH) of a content item.\nOnly properties that are non-null are applied; omitted properties are left unchanged."}},"components/schemas/UpdateFieldValue":{"id":"components/schemas/UpdateFieldValue","kind":"json-schema","title":"UpdateFieldValue","data":{"type":"object","properties":{"id":{"type":"string","nullable":true,"description":"The field identifier","example":"75577384-3C97-45DA-A847-81B00500E25"},"value":{"nullable":true,"type":"object","description":"The field value","example":{"title":"sample title"}}},"additionalProperties":false}},"schema_1322":{"kind":"json-schema","data":{"type":"string"},"id":"schema_1322"},"schema_1323":{"kind":"json-schema","data":{"type":"integer","format":"int32"},"id":"schema_1323"},"schema_1324":{"kind":"json-schema","data":{"type":"array","items":{"type":"string","format":"uuid"}},"id":"schema_1324"},"schema_1325":{"kind":"json-schema","data":{"type":"boolean","default":false},"id":"schema_1325"},"schema_1326":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/LiveDatasourceRequest"}},"id":"schema_1326"},"schema_1327":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/LiveDatasource"}},"id":"schema_1327"},"schema_1328":{"kind":"json-schema","data":{"type":"array","items":{"type":"string"},"example":["4cf51e95-ee7e-4ad6-a69f-e4d740b03616","d9584f11-07d3-4cda-8373-7f97ceedbc09"]},"id":"schema_1328"},"schema_1329":{"kind":"json-schema","data":{"type":"string","example":"en"},"id":"schema_1329"}},"exampleStore":{"paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/responses/400/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7231#section-6.5.1","title":"Bad Request","status":400,"detail":"A detailed explanation, specific to this occurrence of the problem.","instance":"If available, a URI reference that identifies the specific occurrence of the problem.","traceId":"00-982607166a542147b435be3a847ddd71-fc75498eb9f09d48-00","errors":{"sampleProperty":["The sampleProperty field is required"]}},"id":"paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/responses/400/content/application~1json/example"},"paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/responses/401/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7235#section-3.1","title":"Unauthorized","status":401,"traceId":"00-982607166a542147b435be3a847ddd71-fc75498eb9f09d48-00"},"id":"paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/responses/401/content/application~1json/example"},"paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/responses/404/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7231#section-6.5.4","title":"Not Found","status":404,"detail":"A detailed explanation, specific to this occurrence of the problem.","instance":"If available, a URI reference that identifies the specific occurrence of the problem."},"id":"paths/~1api~1v1~1content-items~1{id}~1hierarchy~1children/get/responses/404/content/application~1json/example"},"paths/~1api~1v1~1content-items/get/responses/400/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7231#section-6.5.1","title":"Bad Request","status":400,"detail":"A detailed explanation, specific to this occurrence of the problem.","instance":"If available, a URI reference that identifies the specific occurrence of the problem.","traceId":"00-982607166a542147b435be3a847ddd71-fc75498eb9f09d48-00","errors":{"sampleProperty":["The sampleProperty field is required"]}},"id":"paths/~1api~1v1~1content-items/get/responses/400/content/application~1json/example"},"paths/~1api~1v1~1content-items/get/responses/401/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7235#section-3.1","title":"Unauthorized","status":401,"traceId":"00-982607166a542147b435be3a847ddd71-fc75498eb9f09d48-00"},"id":"paths/~1api~1v1~1content-items/get/responses/401/content/application~1json/example"},"paths/~1api~1v1~1content-items/get/responses/404/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7231#section-6.5.4","title":"Not Found","status":404,"detail":"A detailed explanation, specific to this occurrence of the problem.","instance":"If available, a URI reference that identifies the specific occurrence of the problem."},"id":"paths/~1api~1v1~1content-items/get/responses/404/content/application~1json/example"},"paths/~1api~1v1~1content-items/post/responses/400/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7231#section-6.5.1","title":"Bad Request","status":400,"detail":"A detailed explanation, specific to this occurrence of the problem.","instance":"If available, a URI reference that identifies the specific occurrence of the problem.","traceId":"00-982607166a542147b435be3a847ddd71-fc75498eb9f09d48-00","errors":{"sampleProperty":["The sampleProperty field is required"]}},"id":"paths/~1api~1v1~1content-items/post/responses/400/content/application~1json/example"},"paths/~1api~1v1~1content-items/post/responses/401/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7235#section-3.1","title":"Unauthorized","status":401,"traceId":"00-982607166a542147b435be3a847ddd71-fc75498eb9f09d48-00"},"id":"paths/~1api~1v1~1content-items/post/responses/401/content/application~1json/example"},"paths/~1api~1v1~1content-items~1{id}/get/responses/400/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7231#section-6.5.1","title":"Bad Request","status":400,"detail":"A detailed explanation, specific to this occurrence of the problem.","instance":"If available, a URI reference that identifies the specific occurrence of the problem.","traceId":"00-982607166a542147b435be3a847ddd71-fc75498eb9f09d48-00","errors":{"sampleProperty":["The sampleProperty field is required"]}},"id":"paths/~1api~1v1~1content-items~1{id}/get/responses/400/content/application~1json/example"},"paths/~1api~1v1~1content-items~1{id}/get/responses/401/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7235#section-3.1","title":"Unauthorized","status":401,"traceId":"00-982607166a542147b435be3a847ddd71-fc75498eb9f09d48-00"},"id":"paths/~1api~1v1~1content-items~1{id}/get/responses/401/content/application~1json/example"},"paths/~1api~1v1~1content-items~1{id}/get/responses/404/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7231#section-6.5.4","title":"Not Found","status":404,"detail":"A detailed explanation, specific to this occurrence of the problem.","instance":"If available, a URI reference that identifies the specific occurrence of the problem."},"id":"paths/~1api~1v1~1content-items~1{id}/get/responses/404/content/application~1json/example"},"paths/~1api~1v1~1content-items~1{id}/patch/responses/400/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7231#section-6.5.1","title":"Bad Request","status":400,"detail":"A detailed explanation, specific to this occurrence of the problem.","instance":"If available, a URI reference that identifies the specific occurrence of the problem.","traceId":"00-982607166a542147b435be3a847ddd71-fc75498eb9f09d48-00","errors":{"sampleProperty":["The sampleProperty field is required"]}},"id":"paths/~1api~1v1~1content-items~1{id}/patch/responses/400/content/application~1json/example"},"paths/~1api~1v1~1content-items~1{id}/patch/responses/401/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7235#section-3.1","title":"Unauthorized","status":401,"traceId":"00-982607166a542147b435be3a847ddd71-fc75498eb9f09d48-00"},"id":"paths/~1api~1v1~1content-items~1{id}/patch/responses/401/content/application~1json/example"},"paths/~1api~1v1~1content-items~1{id}/put/responses/400/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7231#section-6.5.1","title":"Bad Request","status":400,"detail":"A detailed explanation, specific to this occurrence of the problem.","instance":"If available, a URI reference that identifies the specific occurrence of the problem.","traceId":"00-982607166a542147b435be3a847ddd71-fc75498eb9f09d48-00","errors":{"sampleProperty":["The sampleProperty field is required"]}},"id":"paths/~1api~1v1~1content-items~1{id}/put/responses/400/content/application~1json/example"},"paths/~1api~1v1~1content-items~1{id}/put/responses/401/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7235#section-3.1","title":"Unauthorized","status":401,"traceId":"00-982607166a542147b435be3a847ddd71-fc75498eb9f09d48-00"},"id":"paths/~1api~1v1~1content-items~1{id}/put/responses/401/content/application~1json/example"},"paths/~1api~1v1~1content-items~1{id}/put/responses/404/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7231#section-6.5.4","title":"Not Found","status":404,"detail":"A detailed explanation, specific to this occurrence of the problem.","instance":"If available, a URI reference that identifies the specific occurrence of the problem."},"id":"paths/~1api~1v1~1content-items~1{id}/put/responses/404/content/application~1json/example"},"paths/~1api~1v1~1content-items~1{id}/delete/responses/401/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7235#section-3.1","title":"Unauthorized","status":401,"traceId":"00-982607166a542147b435be3a847ddd71-fc75498eb9f09d48-00"},"id":"paths/~1api~1v1~1content-items~1{id}/delete/responses/401/content/application~1json/example"},"paths/~1api~1v1~1content-items~1{id}/delete/responses/404/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7231#section-6.5.4","title":"Not Found","status":404,"detail":"A detailed explanation, specific to this occurrence of the problem.","instance":"If available, a URI reference that identifies the specific occurrence of the problem."},"id":"paths/~1api~1v1~1content-items~1{id}/delete/responses/404/content/application~1json/example"},"paths/~1api~1v1~1content-items~1{id}~1validate/get/responses/400/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7231#section-6.5.1","title":"Bad Request","status":400,"detail":"A detailed explanation, specific to this occurrence of the problem.","instance":"If available, a URI reference that identifies the specific occurrence of the problem.","traceId":"00-982607166a542147b435be3a847ddd71-fc75498eb9f09d48-00","errors":{"sampleProperty":["The sampleProperty field is required"]}},"id":"paths/~1api~1v1~1content-items~1{id}~1validate/get/responses/400/content/application~1json/example"},"paths/~1api~1v1~1content-items~1{id}~1validate/get/responses/401/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7235#section-3.1","title":"Unauthorized","status":401,"traceId":"00-982607166a542147b435be3a847ddd71-fc75498eb9f09d48-00"},"id":"paths/~1api~1v1~1content-items~1{id}~1validate/get/responses/401/content/application~1json/example"},"paths/~1api~1v1~1content-items~1{id}~1validate/get/responses/404/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7231#section-6.5.4","title":"Not Found","status":404,"detail":"A detailed explanation, specific to this occurrence of the problem.","instance":"If available, a URI reference that identifies the specific occurrence of the problem."},"id":"paths/~1api~1v1~1content-items~1{id}~1validate/get/responses/404/content/application~1json/example"},"paths/~1api~1v1~1content-items~1live/post/responses/400/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7231#section-6.5.1","title":"Bad Request","status":400,"detail":"A detailed explanation, specific to this occurrence of the problem.","instance":"If available, a URI reference that identifies the specific occurrence of the problem.","traceId":"00-982607166a542147b435be3a847ddd71-fc75498eb9f09d48-00","errors":{"sampleProperty":["The sampleProperty field is required"]}},"id":"paths/~1api~1v1~1content-items~1live/post/responses/400/content/application~1json/example"},"paths/~1api~1v1~1content-items~1{contentItemId}~1hierarchy/get/responses/400/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7231#section-6.5.1","title":"Bad Request","status":400,"detail":"A detailed explanation, specific to this occurrence of the problem.","instance":"If available, a URI reference that identifies the specific occurrence of the problem.","traceId":"00-982607166a542147b435be3a847ddd71-fc75498eb9f09d48-00","errors":{"sampleProperty":["The sampleProperty field is required"]}},"id":"paths/~1api~1v1~1content-items~1{contentItemId}~1hierarchy/get/responses/400/content/application~1json/example"},"paths/~1api~1v1~1content-items~1{contentItemId}~1hierarchy/get/responses/404/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7231#section-6.5.4","title":"Not Found","status":404,"detail":"A detailed explanation, specific to this occurrence of the problem.","instance":"If available, a URI reference that identifies the specific occurrence of the problem."},"id":"paths/~1api~1v1~1content-items~1{contentItemId}~1hierarchy/get/responses/404/content/application~1json/example"},"paths/~1api~1v1~1content-items~1{id}~1translate/post/responses/400/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7231#section-6.5.1","title":"Bad Request","status":400,"detail":"A detailed explanation, specific to this occurrence of the problem.","instance":"If available, a URI reference that identifies the specific occurrence of the problem.","traceId":"00-982607166a542147b435be3a847ddd71-fc75498eb9f09d48-00","errors":{"sampleProperty":["The sampleProperty field is required"]}},"id":"paths/~1api~1v1~1content-items~1{id}~1translate/post/responses/400/content/application~1json/example"},"paths/~1api~1v1~1content-items~1{id}~1translate/post/responses/401/content/application~1json/example":{"value":{"type":"https://tools.ietf.org/html/rfc7235#section-3.1","title":"Unauthorized","status":401,"traceId":"00-982607166a542147b435be3a847ddd71-fc75498eb9f09d48-00"},"id":"paths/~1api~1v1~1content-items~1{id}~1translate/post/responses/401/content/application~1json/example"}},"securitySchemeStore":{"Bearer":{"id":"Bearer","type":"http","scheme":"Bearer","description":"Enter your bearer token in the text input below."}},"servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"specType":"openapi"},"options":{"hideInfoMetadata":true,"sanitize":true,"sortRequiredPropsFirst":true,"corsProxyUrl":"https://cors.redoc.ly","mockServer":{"off":true,"position":"off"},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/sai/content-items-api/index.json?download"},{"url":"/_bundle/sai/content-items-api/index.yaml?download"}],"excludeFromSearch":false,"replayFeatures":{"graphql":false},"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Content Items API","description":"The Content Items API lets you manage content items for an environment. A content item is an instance of a content type that stores structured content and its metadata. Content items contain the actual content used by sites, applications, and other channels. \n\n This REST API lets you: \n\n - Create, retrieve, update and delete content items. \n\n - List live content items. \n\n - Validate and translate content items. \n\n - Retrieve content item hierarchy and hierarchy children. \n\n# Authorization\nTo authorize your requests, use environment automation client credentials and generate a JSON Web Token (JWT).\n\nNote: To create client credentials, you must be an [Organization Admin](https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/roles.html) or Organization Owner.\n\n## Create an automation client\n 1. In the Sitecore Cloud Portal, open SitecoreAI Deploy.\n 2. Click **Credentials** > **Environment** > **Create credentials** > **Automation**.\n 3. Fill out the automation client details, then click **Create**.\n 4. Copy the client ID and the client secret because you won't be able to view them again in SitecoreAI Deploy. You'll use them to request a JWT.\n\n## Request a JWT\n\nRun the following cURL command to request a JWT. Replace the placeholder values with your client ID and client secret.\n```curl\n  curl -X POST 'https://auth.sitecorecloud.io/oauth/token' \\\n  --header 'Content-Type: application/x-www-form-urlencoded' \\\n  --data-urlencode 'client_id={YOUR_CLIENT_ID}' \\\n  --data-urlencode 'client_secret={YOUR_CLIENT_SECRET}' \\\n  --data-urlencode 'grant_type=client_credentials' \\\n  --data-urlencode 'audience=https://api.sitecorecloud.io'\n```\n\nIn the response, the `access_token` key contains the JWT:\n\n```json\n  {\n    \"access_token\": \"{YOUR_JWT}\",\n    \"scope\": \"xmcloud.cm:admin\",\n    \"expires_in\": 86400,\n    \"token_type\": \"Bearer\"\n  }\n```\n\nThe JWT expires in 24 hours. If your requests unexpectedly return a response with status `401 Unauthorized`, request a new JWT by repeating this `POST` request.\n\nWe recommend that you cache the JWT for 24 hours to avoid repeating this `POST` request while the JWT is still valid.\n\n## Include the JWT in the request header\n\nYou can now start making REST API requests. You must include the JWT in the request header of every request. For example:\n  ```curl\n  curl -X GET '{YOUR_BASE_URL}/...' \\\n  -H 'Authorization: Bearer {YOUR_JWT}' \\\n  -H 'Accept: application/json'\n  ```","product":"SitecoreAI"}},"baseSlug":"/sai/content-items-api","routesMapping":{}}