{"items":[{"type":"link","label":"Components API","link":"/sai/components-api","routeSlug":"/sai/components-api","content":{"contentType":"overview","meta":{"name":"Components API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"index.json","url":"/_bundle/sai/components-api/index.json?download"},{"kind":"download","label":"index.yaml","url":"/_bundle/sai/components-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":"Components 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":"Use the SitecoreAI Components API to manage components, data sources, and component categories."},"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":"Manage components for a site, including its rendering parameters, and the editing controls that determine the appearance of the component in an editing interface such as the Page Builder."},"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":"Read and update data sources and read data source hierarchies for an environment."},"children":[]}]}]}]}]}]}],"sectionId":"/sai/components-api"}],"sectionId":"/sai/components-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/components-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/components-api/section/authorization/create-an-automation-client"}],"sectionId":"/sai/components-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/components-api/section/authorization/request-a-jwt"}],"sectionId":"/sai/components-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/components-api/section/authorization/include-the-jwt-in-the-request-header"}],"sectionId":"/sai/components-api/section/authorization/include-the-jwt-in-the-request-header"}]}]}},{"type":"group","label":"Authorization","link":"/sai/components-api/section/authorization","routeSlug":"/sai/components-api/section/authorization","items":[{"type":"link","label":"Create an automation client","link":"/sai/components-api/section/authorization/create-an-automation-client","routeSlug":"/sai/components-api/section/authorization/create-an-automation-client","content":null},{"type":"link","label":"Request a JWT","link":"/sai/components-api/section/authorization/request-a-jwt","routeSlug":"/sai/components-api/section/authorization/request-a-jwt","content":null},{"type":"link","label":"Include the JWT in the request header","link":"/sai/components-api/section/authorization/include-the-jwt-in-the-request-header","routeSlug":"/sai/components-api/section/authorization/include-the-jwt-in-the-request-header","content":null}],"content":null},{"type":"group","label":"Categories","link":"/sai/components-api/categories","routeSlug":"/sai/components-api/categories","items":[{"label":"List component categories","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/components-api/categories/listcomponentscategories","routeSlug":"/sai/components-api/categories/listcomponentscategories","metadata":{"seo":{"title":"List component categories","description":"Fetches the list of component categories."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ListComponentsCategories","name":"List component categories","isWebhook":false,"pointer":"/paths/~1api~1v1~1component-categories/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List component categories","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Fetches the list of component categories."},{"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_1309","description":"The environment identifier.","example":"main"}],"pointer":"/paths/~1api~1v1~1component-categories/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/component-categories","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1309"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"responseCodes":["200","400","401"],"pointer":"/api/v1/component-categories","href":"categories/listcomponentscategories","openApiOperationId":"ListComponentsCategories","summary":"List component categories"},"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":"schema_1310"}},"schemaId":"schema_1310"},{"code":"400","description":"One or more validation errors occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1component-categories/get/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1component-categories/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~1component-categories/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1component-categories/get/responses/401/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1component-categories/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1310","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1310"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1component-categories/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1component-categories/get/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1component-categories/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1component-categories/get/responses/401/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/categories/listcomponentscategories"}],"panels":[]}]},"httpPath":"/api/v1/component-categories"},{"label":"List components in a category","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/components-api/categories/listcategorycomponents","routeSlug":"/sai/components-api/categories/listcategorycomponents","metadata":{"seo":{"title":"List components in a category","description":"Fetches the list of components in a specific component category."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ListCategoryComponents","name":"List components in a category","isWebhook":false,"pointer":"/paths/~1api~1v1~1component-categories~1{category}~1components/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List components in a category","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Fetches the list of components in a specific component category."},{"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":"category","in":"path","schemaId":"schema_1309","description":"The Item ID or Item name of the component category.","required":true,"example":"Page%20Content"}],"pointer":"/paths/~1api~1v1~1component-categories~1{category}~1components/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"environmentId","in":"query","schemaId":"schema_1309","description":"The environment identifier.","example":"main"}],"pointer":"/paths/~1api~1v1~1component-categories~1{category}~1components/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/component-categories/{category}/components","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[{"name":"category","in":"path","required":true,"example":"Page%20Content","schemaId":"schema_1309"}],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1309"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"responseCodes":["200","400","401"],"pointer":"/api/v1/component-categories/{category}/components","href":"categories/listcategorycomponents","openApiOperationId":"ListCategoryComponents","summary":"List components in a category"},"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":"schema_1311"}},"schemaId":"schema_1311"},{"code":"400","description":"One or more validation errors occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1component-categories~1{category}~1components/get/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1component-categories~1{category}~1components/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~1component-categories~1{category}~1components/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1component-categories~1{category}~1components/get/responses/401/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1component-categories~1{category}~1components/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1311","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1311"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1component-categories~1{category}~1components/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1component-categories~1{category}~1components/get/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1component-categories~1{category}~1components/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1component-categories~1{category}~1components/get/responses/401/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/categories/listcategorycomponents"}],"panels":[]}]},"httpPath":"/api/v1/component-categories/{category}/components"}],"content":{"contentType":"group","meta":{"name":"Categories"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Categories","showPageActions":true},{"nodeType":"markdoc","content":"The Categories API lets you manage component categories for an environment"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v1/component-categories","summary":"List component categories","prefix":{"name":"get","color":"get"},"badges":[],"link":"/categories/listcomponentscategories","deprecated":false},{"title":"/api/v1/component-categories/{category}/components","summary":"List components in a category","prefix":{"name":"get","color":"get"},"badges":[],"link":"/categories/listcategorycomponents","deprecated":false}]}]}]}]}},{"type":"group","label":"Components","link":"/sai/components-api/components","routeSlug":"/sai/components-api/components","items":[{"label":"Retrieve a component draft","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/components-api/components/retrievedraft","routeSlug":"/sai/components-api/components/retrievedraft","metadata":{"seo":{"title":"Retrieve a component draft","description":"Retrieves a component draft by id."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"RetrieveDraft","name":"Retrieve a component draft","isWebhook":false,"pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a component draft","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves a component draft by id."},{"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":"componentDraftId","in":"path","schemaId":"schema_1309","description":"The component draft identifier.","required":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276"}],"pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"environmentId","in":"query","schemaId":"schema_1309","description":"The environment identifier.","example":"main"}],"pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/components/drafts/{componentDraftId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[{"name":"componentDraftId","in":"path","required":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276","schemaId":"schema_1309"}],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1309"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"responseCodes":["200","400","401","404"],"pointer":"/api/v1/components/drafts/{componentDraftId}","href":"components/retrievedraft","openApiOperationId":"RetrieveDraft","summary":"Retrieve a component draft"},"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/ComponentDraft"}},"schemaId":"components/schemas/ComponentDraft"},{"code":"400","description":"One or more validation errors occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/get/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/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~1components~1drafts~1{componentDraftId}/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/get/responses/401/content/application~1json/example"]},{"code":"404","description":"Invalid component draft id","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/get/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/get/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ComponentDraft","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ComponentDraft"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/get/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/get/responses/401/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/get/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/get/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/retrievedraft"}],"panels":[]}]},"httpPath":"/api/v1/components/drafts/{componentDraftId}"},{"label":"Update a component draft","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/components-api/components/patchdraft","routeSlug":"/sai/components-api/components/patchdraft","metadata":{"seo":{"title":"Update a component draft","description":"Updates a component draft."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"PatchDraft","name":"Update a component draft","isWebhook":false,"pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a component draft","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Updates a component draft."},{"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":"componentDraftId","in":"path","schemaId":"schema_1309","description":"The component draft identifier.","required":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276"}],"pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}/patch/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"environmentId","in":"query","schemaId":"schema_1309","description":"The environment identifier.","example":"main"}],"pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}/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/UpdateComponentDraftInput"},"text/json":{"schemaId":"components/schemas/UpdateComponentDraftInput"},"application/*+json":{"schemaId":"components/schemas/UpdateComponentDraftInput"}},"schemaId":"components/schemas/UpdateComponentDraftInput","pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}/patch/requestBody","description":"Details of the component draft to update."}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/api/v1/components/drafts/{componentDraftId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[{"name":"componentDraftId","in":"path","required":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276","schemaId":"schema_1309"}],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1309"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateComponentDraftInput"},"text/json":{"schemaId":"components/schemas/UpdateComponentDraftInput"},"application/*+json":{"schemaId":"components/schemas/UpdateComponentDraftInput"}},"responseCodes":["200","400","401","404","502"],"pointer":"/api/v1/components/drafts/{componentDraftId}","href":"components/patchdraft","openApiOperationId":"PatchDraft","summary":"Update a component draft"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"schemaId":"components/schemas/UpdateComponentDraftInput","mediaTypes":["application/json","text/json","application/*+json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateComponentDraftInput"},"text/json":{"schemaId":"components/schemas/UpdateComponentDraftInput"},"application/*+json":{"schemaId":"components/schemas/UpdateComponentDraftInput"}},"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/ComponentDraft"}},"schemaId":"components/schemas/ComponentDraft"},{"code":"400","description":"One or more validation errors occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/patch/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/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~1components~1drafts~1{componentDraftId}/patch/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/patch/responses/401/content/application~1json/example"]},{"code":"404","description":"Invalid component draft id","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/patch/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/patch/responses/404/content/application~1json/example"]},{"code":"502","description":"Bad Gateway"}],"pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ComponentDraft","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ComponentDraft"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/patch/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/patch/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/patch/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/patch/responses/401/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/patch/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/patch/responses/404/content/application~1json/example"]}}},{"code":"502"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/patchdraft"}],"panels":[]}]},"httpPath":"/api/v1/components/drafts/{componentDraftId}"},{"label":"Update a component draft","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/components-api/components/updatedraft","routeSlug":"/sai/components-api/components/updatedraft","metadata":{"seo":{"title":"Update a component draft","description":"Fully replaces a component draft. All user-editable fields are replaced with the provided values.Null values reset optional fields to their defaults. Unlike PATCH, the entire Variants collectionis replaced — any existing variant not present in the request body is removed."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"UpdateDraft","name":"Update a component draft","isWebhook":false,"pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a component draft","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":"Fully replaces a component draft. All user-editable fields are replaced with the provided values."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Null values reset optional fields to their defaults. Unlike PATCH, the entire Variants collection"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is replaced — any existing variant not present in the request body is removed."},"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":"componentDraftId","in":"path","schemaId":"schema_1309","description":"The component draft identifier.","required":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276"}],"pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}/put/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"environmentId","in":"query","schemaId":"schema_1309","description":"The environment identifier.","example":"main"}],"pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}/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/ReplaceComponentDraftInput"},"text/json":{"schemaId":"components/schemas/ReplaceComponentDraftInput"},"application/*+json":{"schemaId":"components/schemas/ReplaceComponentDraftInput"}},"schemaId":"components/schemas/ReplaceComponentDraftInput","pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}/put/requestBody","description":"Details of the component draft to update."}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v1/components/drafts/{componentDraftId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[{"name":"componentDraftId","in":"path","required":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276","schemaId":"schema_1309"}],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1309"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ReplaceComponentDraftInput"},"text/json":{"schemaId":"components/schemas/ReplaceComponentDraftInput"},"application/*+json":{"schemaId":"components/schemas/ReplaceComponentDraftInput"}},"responseCodes":["200","400","401","404","502"],"pointer":"/api/v1/components/drafts/{componentDraftId}","href":"components/updatedraft","openApiOperationId":"UpdateDraft","summary":"Update a component draft"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"schemaId":"components/schemas/ReplaceComponentDraftInput","mediaTypes":["application/json","text/json","application/*+json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ReplaceComponentDraftInput"},"text/json":{"schemaId":"components/schemas/ReplaceComponentDraftInput"},"application/*+json":{"schemaId":"components/schemas/ReplaceComponentDraftInput"}},"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/ComponentDraft"}},"schemaId":"components/schemas/ComponentDraft"},{"code":"400","description":"One or more validation errors occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/put/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/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~1components~1drafts~1{componentDraftId}/put/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/put/responses/401/content/application~1json/example"]},{"code":"404","description":"Invalid component draft id","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/put/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/put/responses/404/content/application~1json/example"]},{"code":"502","description":"Bad Gateway"}],"pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}/put/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ComponentDraft","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ComponentDraft"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/put/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/put/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/put/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/put/responses/401/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/put/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/put/responses/404/content/application~1json/example"]}}},{"code":"502"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/updatedraft"}],"panels":[]}]},"httpPath":"/api/v1/components/drafts/{componentDraftId}"},{"label":"Delete a component draft","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/components-api/components/deletedraft","routeSlug":"/sai/components-api/components/deletedraft","metadata":{"seo":{"title":"Delete a component draft","description":"Deletes a component draft by id."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"DeleteDraft","name":"Delete a component draft","isWebhook":false,"pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a component draft","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Deletes a component draft by id."},{"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":"componentDraftId","in":"path","schemaId":"schema_1309","description":"The component draft identifier.","required":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276"}],"pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}/delete/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"environmentId","in":"query","schemaId":"schema_1309","description":"The environment identifier.","example":"main"}],"pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v1/components/drafts/{componentDraftId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[{"name":"componentDraftId","in":"path","required":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276","schemaId":"schema_1309"}],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1309"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"responseCodes":["204","400","401","404"],"pointer":"/api/v1/components/drafts/{componentDraftId}","href":"components/deletedraft","openApiOperationId":"DeleteDraft","summary":"Delete a component draft"},"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":"400","description":"One or more validation errors occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/delete/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/delete/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~1components~1drafts~1{componentDraftId}/delete/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/delete/responses/401/content/application~1json/example"]},{"code":"404","description":"Invalid component draft id","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/delete/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/delete/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}/delete/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"204"},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/delete/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/delete/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/delete/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/delete/responses/401/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/delete/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}/delete/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/deletedraft"}],"panels":[]}]},"httpPath":"/api/v1/components/drafts/{componentDraftId}"},{"label":"List component drafts","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/components-api/components/listdrafts","routeSlug":"/sai/components-api/components/listdrafts","metadata":{"seo":{"title":"List component drafts","description":"Lists component drafts."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ListDrafts","name":"List component drafts","isWebhook":false,"pointer":"/paths/~1api~1v1~1components~1drafts/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List component drafts","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Lists component drafts."},{"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_1309","description":"The environment identifier.","example":"main"}],"pointer":"/paths/~1api~1v1~1components~1drafts/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/components/drafts","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1309"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"responseCodes":["200","400","401"],"pointer":"/api/v1/components/drafts","href":"components/listdrafts","openApiOperationId":"ListDrafts","summary":"List component drafts"},"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. The content type draft in the response body is the content type draft associated with this component draft.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1312"}},"schemaId":"schema_1312"},{"code":"400","description":"One or more validation errors occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts/get/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts/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~1components~1drafts/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts/get/responses/401/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1components~1drafts/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1312","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1312"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts/get/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts/get/responses/401/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/listdrafts"}],"panels":[]}]},"httpPath":"/api/v1/components/drafts"},{"label":"Create a component draft","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/components-api/components/createdraft","routeSlug":"/sai/components-api/components/createdraft","metadata":{"seo":{"title":"Create a component draft","description":"Creates a component draft."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CreateDraft","name":"Create a component draft","isWebhook":false,"pointer":"/paths/~1api~1v1~1components~1drafts/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a component draft","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates a component draft."},{"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_1309","description":"The environment identifier.","example":"main"}],"pointer":"/paths/~1api~1v1~1components~1drafts/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/CreateComponentDraftInput"},"text/json":{"schemaId":"components/schemas/CreateComponentDraftInput"},"application/*+json":{"schemaId":"components/schemas/CreateComponentDraftInput"}},"schemaId":"components/schemas/CreateComponentDraftInput","pointer":"/paths/~1api~1v1~1components~1drafts/post/requestBody","description":"Details of the component draft to create."}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/components/drafts","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1309"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateComponentDraftInput"},"text/json":{"schemaId":"components/schemas/CreateComponentDraftInput"},"application/*+json":{"schemaId":"components/schemas/CreateComponentDraftInput"}},"responseCodes":["201","400","401"],"pointer":"/api/v1/components/drafts","href":"components/createdraft","openApiOperationId":"CreateDraft","summary":"Create a component draft"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"schemaId":"components/schemas/CreateComponentDraftInput","mediaTypes":["application/json","text/json","application/*+json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateComponentDraftInput"},"text/json":{"schemaId":"components/schemas/CreateComponentDraftInput"},"application/*+json":{"schemaId":"components/schemas/CreateComponentDraftInput"}},"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. ContentModel object can be empty once created but it can be populated subsequently using the Patch/Update Draft endpoint.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ComponentDraft"}},"schemaId":"components/schemas/ComponentDraft"},{"code":"400","description":"One or more validation errors occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts/post/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts/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~1components~1drafts/post/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts/post/responses/401/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1components~1drafts/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/ComponentDraft","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ComponentDraft"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts/post/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts/post/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts/post/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts/post/responses/401/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/createdraft"}],"panels":[]}]},"httpPath":"/api/v1/components/drafts"},{"label":"List components","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/components-api/components/listcomponents","routeSlug":"/sai/components-api/components/listcomponents","metadata":{"seo":{"title":"List components","description":"Retrieves a list of components and their details for all sites or specific sites."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ListComponents","name":"List components","isWebhook":false,"pointer":"/paths/~1api~1v1~1components/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List components","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves a list of components and their details for all sites or specific sites."},{"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":"siteId","in":"query","schemaId":"schema_1309","description":"The site identifier.","example":"497f6eca-6276-4993-bfeb-53cbbbba6f08"},{"name":"environmentId","in":"query","schemaId":"schema_1309","description":"The environment identifier. Defaults to \"main\". Currently only \"main\" is supported.","example":"main"}],"pointer":"/paths/~1api~1v1~1components/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/components","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"siteId","in":"query","example":"497f6eca-6276-4993-bfeb-53cbbbba6f08","schemaId":"schema_1309"},{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1309"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"responseCodes":["200","400","401"],"pointer":"/api/v1/components","href":"components/listcomponents","openApiOperationId":"ListComponents","summary":"List components"},"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":"schema_1311"}},"schemaId":"schema_1311"},{"code":"400","description":"One or more validation errors occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components/get/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components/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~1components/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components/get/responses/401/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1components/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1311","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1311"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components/get/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components/get/responses/401/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/listcomponents"}],"panels":[]}]},"httpPath":"/api/v1/components"},{"label":"Create a component","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/components-api/components/createcomponent","routeSlug":"/sai/components-api/components/createcomponent","metadata":{"seo":{"title":"Create a component","description":"Creates a component."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CreateComponent","name":"Create a component","isWebhook":false,"pointer":"/paths/~1api~1v1~1components/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a component","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates a component."},{"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_1309","description":"The environment identifier.","example":"main"}],"pointer":"/paths/~1api~1v1~1components/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/CreateComponentInput"},"text/json":{"schemaId":"components/schemas/CreateComponentInput"},"application/*+json":{"schemaId":"components/schemas/CreateComponentInput"}},"schemaId":"components/schemas/CreateComponentInput","pointer":"/paths/~1api~1v1~1components/post/requestBody","description":"Details of the component to create."}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/components","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1309"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateComponentInput"},"text/json":{"schemaId":"components/schemas/CreateComponentInput"},"application/*+json":{"schemaId":"components/schemas/CreateComponentInput"}},"responseCodes":["201","400","401","404"],"pointer":"/api/v1/components","href":"components/createcomponent","openApiOperationId":"CreateComponent","summary":"Create a component"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"schemaId":"components/schemas/CreateComponentInput","mediaTypes":["application/json","text/json","application/*+json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateComponentInput"},"text/json":{"schemaId":"components/schemas/CreateComponentInput"},"application/*+json":{"schemaId":"components/schemas/CreateComponentInput"}},"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. The variants array in the response body will be empty on create as no variants exist yet","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Component"}},"schemaId":"components/schemas/Component"},{"code":"400","description":"One or more validation errors occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components/post/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components/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~1components/post/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components/post/responses/401/content/application~1json/example"]},{"code":"404","description":"Provided content type not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components/post/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components/post/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1components/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/Component","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Component"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components/post/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components/post/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components/post/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components/post/responses/401/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components/post/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components/post/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/createcomponent"}],"panels":[]}]},"httpPath":"/api/v1/components"},{"label":"List component summaries","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/components-api/components/listcomponentsummaries","routeSlug":"/sai/components-api/components/listcomponentsummaries","metadata":{"seo":{"title":"List component summaries","description":"Retrieves a lightweight list of components containing only id, name, displayName, systemName and modelId for all sites or specific sites. Use this endpoint for any scenario that does not require full component details."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ListComponentSummaries","name":"List component summaries","isWebhook":false,"pointer":"/paths/~1api~1v1~1components~1summaries/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List component summaries","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":"Retrieves a lightweight list of components containing only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"displayName"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"systemName"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"modelId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for all sites or specific sites. Use this endpoint for any scenario that does not require full component details."},"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":"siteId","in":"query","schemaId":"schema_1309","description":"The site identifier.","example":"497f6eca-6276-4993-bfeb-53cbbbba6f08"},{"name":"environmentId","in":"query","schemaId":"schema_1309","description":"The environment identifier. Defaults to \"main\". Currently only \"main\" is supported.","example":"main"}],"pointer":"/paths/~1api~1v1~1components~1summaries/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/components/summaries","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"siteId","in":"query","example":"497f6eca-6276-4993-bfeb-53cbbbba6f08","schemaId":"schema_1309"},{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1309"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"responseCodes":["200","400","401"],"pointer":"/api/v1/components/summaries","href":"components/listcomponentsummaries","openApiOperationId":"ListComponentSummaries","summary":"List component summaries"},"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":"schema_1313"}},"schemaId":"schema_1313"},{"code":"400","description":"One or more validation errors occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1summaries/get/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1summaries/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~1components~1summaries/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1summaries/get/responses/401/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1components~1summaries/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1313","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1313"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1summaries/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1summaries/get/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1summaries/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1summaries/get/responses/401/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/listcomponentsummaries"}],"panels":[]}]},"httpPath":"/api/v1/components/summaries"},{"label":"Retrieve a component","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/components-api/components/retrievecomponent","routeSlug":"/sai/components-api/components/retrievecomponent","metadata":{"seo":{"title":"Retrieve a component","description":"Retrieves a component and its details."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"RetrieveComponent","name":"Retrieve a component","isWebhook":false,"pointer":"/paths/~1api~1v1~1components~1{componentId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a component","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves a component and its details."},{"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":"componentId","in":"path","schemaId":"schema_1309","description":"The component identifier.","required":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276"}],"pointer":"/paths/~1api~1v1~1components~1{componentId}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"siteId","in":"query","schemaId":"schema_1309","description":"The site identifier.","example":"497f6eca-6276-4993-bfeb-53cbbbba6f08"},{"name":"environmentId","in":"query","schemaId":"schema_1309","description":"The environment identifier. Defaults to \"main\". Currently only \"main\" is supported.","example":"main"}],"pointer":"/paths/~1api~1v1~1components~1{componentId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/components/{componentId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[{"name":"componentId","in":"path","required":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276","schemaId":"schema_1309"}],"query":[{"name":"siteId","in":"query","example":"497f6eca-6276-4993-bfeb-53cbbbba6f08","schemaId":"schema_1309"},{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1309"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"responseCodes":["200","400","401","404"],"pointer":"/api/v1/components/{componentId}","href":"components/retrievecomponent","openApiOperationId":"RetrieveComponent","summary":"Retrieve a component"},"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/Component"}},"schemaId":"components/schemas/Component"},{"code":"400","description":"One or more validation errors occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/get/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/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~1components~1{componentId}/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/get/responses/401/content/application~1json/example"]},{"code":"404","description":"Component not found or not available for the requested site","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/get/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/get/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1components~1{componentId}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Component","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Component"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/get/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/get/responses/401/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/get/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/get/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/retrievecomponent"}],"panels":[]}]},"httpPath":"/api/v1/components/{componentId}"},{"label":"Update a component","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/components-api/components/updatecomponent","routeSlug":"/sai/components-api/components/updatecomponent","metadata":{"seo":{"title":"Update a component","description":"Updates a component."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"UpdateComponent","name":"Update a component","isWebhook":false,"pointer":"/paths/~1api~1v1~1components~1{componentId}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a component","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Updates a component."},{"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":"componentId","in":"path","schemaId":"schema_1309","description":"The component identifier.","required":true}],"pointer":"/paths/~1api~1v1~1components~1{componentId}/patch/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"environmentId","in":"query","schemaId":"schema_1309","description":"The environment identifier. Defaults to \"main\". Currently only \"main\" is supported.","example":"main"}],"pointer":"/paths/~1api~1v1~1components~1{componentId}/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/UpdateComponentInput"},"text/json":{"schemaId":"components/schemas/UpdateComponentInput"},"application/*+json":{"schemaId":"components/schemas/UpdateComponentInput"}},"schemaId":"components/schemas/UpdateComponentInput","pointer":"/paths/~1api~1v1~1components~1{componentId}/patch/requestBody","description":"Details of the component to update."}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/api/v1/components/{componentId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[{"name":"componentId","in":"path","required":true,"schemaId":"schema_1309"}],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1309"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateComponentInput"},"text/json":{"schemaId":"components/schemas/UpdateComponentInput"},"application/*+json":{"schemaId":"components/schemas/UpdateComponentInput"}},"responseCodes":["201","400","401","404"],"pointer":"/api/v1/components/{componentId}","href":"components/updatecomponent","openApiOperationId":"UpdateComponent","summary":"Update a component"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"schemaId":"components/schemas/UpdateComponentInput","mediaTypes":["application/json","text/json","application/*+json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateComponentInput"},"text/json":{"schemaId":"components/schemas/UpdateComponentInput"},"application/*+json":{"schemaId":"components/schemas/UpdateComponentInput"}},"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/Component"}},"schemaId":"components/schemas/Component"},{"code":"400","description":"One or more validation errors occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/patch/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/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~1components~1{componentId}/patch/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/patch/responses/401/content/application~1json/example"]},{"code":"404","description":"Invalid model","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/patch/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/patch/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1components~1{componentId}/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/Component","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Component"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/patch/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/patch/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/patch/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/patch/responses/401/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/patch/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}/patch/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/updatecomponent"}],"panels":[]}]},"httpPath":"/api/v1/components/{componentId}"},{"label":"Retrieve component metadata","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/components-api/components/retrievecomponentmetadata","routeSlug":"/sai/components-api/components/retrievecomponentmetadata","metadata":{"seo":{"title":"Retrieve component metadata","description":"Fetches the metadata of a component."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"RetrieveComponentMetadata","name":"Retrieve component metadata","isWebhook":false,"pointer":"/paths/~1api~1v1~1components~1{componentId}~1metadata/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve component metadata","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Fetches the metadata of a component."},{"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":"componentId","in":"path","schemaId":"schema_1309","description":"The component identifier.","required":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276"}],"pointer":"/paths/~1api~1v1~1components~1{componentId}~1metadata/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"siteId","in":"query","schemaId":"schema_1309","description":"The site identifier.","required":true,"example":"497f6eca-6276-4993-bfeb-53cbbbba6f08"},{"name":"contextItemId","in":"query","schemaId":"schema_1309","description":"The context item identifier.","required":true,"example":"2f34355e-c52d-450e-b1b9-d4e9cbe64af2"},{"name":"componentName","in":"query","schemaId":"schema_1309","description":"The component name.","example":"Promo"},{"name":"renderingHostName","in":"query","schemaId":"schema_1309","description":"The rendering host name.","required":true,"example":"nextjs-production"},{"name":"environmentId","in":"query","schemaId":"schema_1309","description":"The environment identifier.","example":"main"}],"pointer":"/paths/~1api~1v1~1components~1{componentId}~1metadata/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/components/{componentId}/metadata","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[{"name":"componentId","in":"path","required":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276","schemaId":"schema_1309"}],"query":[{"name":"siteId","in":"query","required":true,"example":"497f6eca-6276-4993-bfeb-53cbbbba6f08","schemaId":"schema_1309"},{"name":"contextItemId","in":"query","required":true,"example":"2f34355e-c52d-450e-b1b9-d4e9cbe64af2","schemaId":"schema_1309"},{"name":"componentName","in":"query","example":"Promo","schemaId":"schema_1309"},{"name":"renderingHostName","in":"query","required":true,"example":"nextjs-production","schemaId":"schema_1309"},{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1309"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"responseCodes":["200","400","401","404"],"pointer":"/api/v1/components/{componentId}/metadata","href":"components/retrievecomponentmetadata","openApiOperationId":"RetrieveComponentMetadata","summary":"Retrieve component metadata"},"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/ComponentMetadata"}},"schemaId":"components/schemas/ComponentMetadata"},{"code":"400","description":"One or more validation errors occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1metadata/get/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1metadata/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~1components~1{componentId}~1metadata/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1metadata/get/responses/401/content/application~1json/example"]},{"code":"404","description":"Invalid component or site ID","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1metadata/get/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1metadata/get/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1components~1{componentId}~1metadata/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ComponentMetadata","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ComponentMetadata"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1metadata/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1metadata/get/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1metadata/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1metadata/get/responses/401/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1metadata/get/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1metadata/get/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/retrievecomponentmetadata"}],"panels":[]}]},"httpPath":"/api/v1/components/{componentId}/metadata"},{"label":"Retrieve component variant metadata by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/components-api/components/retrievecomponentvariantmetadata","routeSlug":"/sai/components-api/components/retrievecomponentvariantmetadata","metadata":{"seo":{"title":"Retrieve component variant metadata by ID","description":"Fetches component variant metadata."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"RetrieveComponentVariantMetadata","name":"Retrieve component variant metadata by ID","isWebhook":false,"pointer":"/paths/~1api~1v1~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve component variant metadata by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Fetches component variant metadata."},{"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":"componentId","in":"path","schemaId":"schema_1309","description":"The component identifier.","required":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276"},{"name":"componentVariantId","in":"path","schemaId":"schema_1309","description":"The component variant identifier.","required":true,"example":"2f34355e-c52d-450e-b1b9-d4e9cbe64af2"}],"pointer":"/paths/~1api~1v1~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"siteId","in":"query","schemaId":"schema_1309","description":"The site identifier.","required":true,"example":"497f6eca-6276-4993-bfeb-53cbbbba6f08"},{"name":"environmentId","in":"query","schemaId":"schema_1309","description":"The environment identifier. Defaults to \"main\". Currently only \"main\" is supported.","example":"main"}],"pointer":"/paths/~1api~1v1~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/components/{componentId}/variant/{componentVariantId}/metadata","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[{"name":"componentId","in":"path","required":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276","schemaId":"schema_1309"},{"name":"componentVariantId","in":"path","required":true,"example":"2f34355e-c52d-450e-b1b9-d4e9cbe64af2","schemaId":"schema_1309"}],"query":[{"name":"siteId","in":"query","required":true,"example":"497f6eca-6276-4993-bfeb-53cbbbba6f08","schemaId":"schema_1309"},{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1309"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"responseCodes":["200","400","401","404"],"pointer":"/api/v1/components/{componentId}/variant/{componentVariantId}/metadata","href":"components/retrievecomponentvariantmetadata","openApiOperationId":"RetrieveComponentVariantMetadata","summary":"Retrieve component variant metadata by ID"},"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/ComponentVariantMetadata"}},"schemaId":"components/schemas/ComponentVariantMetadata"},{"code":"400","description":"One or more validation errors occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/get/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/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~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/get/responses/401/content/application~1json/example"]},{"code":"404","description":"Invalid component or site ID","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/get/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/get/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ComponentVariantMetadata","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ComponentVariantMetadata"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/get/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/get/responses/401/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/get/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/get/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/retrievecomponentvariantmetadata"}],"panels":[]}]},"httpPath":"/api/v1/components/{componentId}/variant/{componentVariantId}/metadata"},{"label":"Get sites where specified component is allowed","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/components-api/components/retrievesitesbycomponentid","routeSlug":"/sai/components-api/components/retrievesitesbycomponentid","metadata":{"seo":{"title":"Get sites where specified component is allowed","description":"Returns an array of sites where the specified component is allowed."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"RetrieveSitesByComponentId","name":"Get sites where specified component is allowed","isWebhook":false,"pointer":"/paths/~1api~1v1~1components~1{componentId}~1sites/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get sites where specified component is allowed","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns an array of sites where the specified component is allowed."},{"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":"componentId","in":"path","schemaId":"schema_1309","description":"The component identifier.","required":true,"example":"C5F905F8-FD1F-444E-A9E5-AC6B774FF0DE"}],"pointer":"/paths/~1api~1v1~1components~1{componentId}~1sites/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"environmentId","in":"query","schemaId":"schema_1309","description":"The environment identifier. Defaults to \"main\". Currently only \"main\" is supported.","example":"main"}],"pointer":"/paths/~1api~1v1~1components~1{componentId}~1sites/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/components/{componentId}/sites","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[{"name":"componentId","in":"path","required":true,"example":"C5F905F8-FD1F-444E-A9E5-AC6B774FF0DE","schemaId":"schema_1309"}],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1309"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"responseCodes":["200","400","401"],"pointer":"/api/v1/components/{componentId}/sites","href":"components/retrievesitesbycomponentid","openApiOperationId":"RetrieveSitesByComponentId","summary":"Get sites where specified component is allowed"},"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":"schema_1314"}},"schemaId":"schema_1314"},{"code":"400","description":"Invalid component ID","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1sites/get/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1sites/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~1components~1{componentId}~1sites/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1sites/get/responses/401/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1components~1{componentId}~1sites/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1314","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1314"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1sites/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1sites/get/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1sites/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1{componentId}~1sites/get/responses/401/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/retrievesitesbycomponentid"}],"panels":[]}]},"httpPath":"/api/v1/components/{componentId}/sites"},{"label":"Generate a draft content type suggestion","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/components-api/components/createdraftmodelsuggestion","routeSlug":"/sai/components-api/components/createdraftmodelsuggestion","metadata":{"seo":{"title":"Generate a draft content type suggestion","description":"Generates a content type suggestion from all draft variant code by calling the AI Service."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CreateDraftModelSuggestion","name":"Generate a draft content type suggestion","isWebhook":false,"pointer":"/paths/~1api~1v1~1components~1drafts~1{id}~1model-suggestion/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Generate a draft content type suggestion","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Generates a content type suggestion from all draft variant code by calling the AI Service."},{"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_1309","description":"The component draft identifier.","required":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276"}],"pointer":"/paths/~1api~1v1~1components~1drafts~1{id}~1model-suggestion/post/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"environmentId","in":"query","schemaId":"schema_1309","description":"The environment identifier.","example":"main"}],"pointer":"/paths/~1api~1v1~1components~1drafts~1{id}~1model-suggestion/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/CreateDraftModelSuggestionInput"},"text/json":{"schemaId":"components/schemas/CreateDraftModelSuggestionInput"},"application/*+json":{"schemaId":"components/schemas/CreateDraftModelSuggestionInput"}},"schemaId":"components/schemas/CreateDraftModelSuggestionInput","pointer":"/paths/~1api~1v1~1components~1drafts~1{id}~1model-suggestion/post/requestBody","description":"Optional payload containing Rendering Host atoms to enhance the AI model suggestion alongside variant code."}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/components/drafts/{id}/model-suggestion","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276","schemaId":"schema_1309"}],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1309"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateDraftModelSuggestionInput"},"text/json":{"schemaId":"components/schemas/CreateDraftModelSuggestionInput"},"application/*+json":{"schemaId":"components/schemas/CreateDraftModelSuggestionInput"}},"responseCodes":["200","400","401","404"],"pointer":"/api/v1/components/drafts/{id}/model-suggestion","href":"components/createdraftmodelsuggestion","openApiOperationId":"CreateDraftModelSuggestion","summary":"Generate a draft content type suggestion"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"schemaId":"components/schemas/CreateDraftModelSuggestionInput","mediaTypes":["application/json","text/json","application/*+json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateDraftModelSuggestionInput"},"text/json":{"schemaId":"components/schemas/CreateDraftModelSuggestionInput"},"application/*+json":{"schemaId":"components/schemas/CreateDraftModelSuggestionInput"}},"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/ContentModelDraft"}},"schemaId":"components/schemas/ContentModelDraft"},{"code":"400","description":"One or more validation errors occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{id}~1model-suggestion/post/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{id}~1model-suggestion/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~1components~1drafts~1{id}~1model-suggestion/post/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{id}~1model-suggestion/post/responses/401/content/application~1json/example"]},{"code":"404","description":"Invalid component draft id","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{id}~1model-suggestion/post/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{id}~1model-suggestion/post/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1components~1drafts~1{id}~1model-suggestion/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ContentModelDraft","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContentModelDraft"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{id}~1model-suggestion/post/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{id}~1model-suggestion/post/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{id}~1model-suggestion/post/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{id}~1model-suggestion/post/responses/401/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{id}~1model-suggestion/post/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{id}~1model-suggestion/post/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/createdraftmodelsuggestion"}],"panels":[]}]},"httpPath":"/api/v1/components/drafts/{id}/model-suggestion"},{"label":"Activate a component draft","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/components-api/components/activatedraft","routeSlug":"/sai/components-api/components/activatedraft","metadata":{"seo":{"title":"Activate a component draft","description":"Activates an existing component draft by creating the corresponding content type (when present),component, and variants, then permanently removes the draft from storage.Activation is a one-way operation — once successful the draft is no longer retrievable.When activation availability is omitted, the endpoint falls back to the draft's stored availability.If neither activation input nor the stored draft defines site assignments, the component is created without site assignments."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ActivateDraft","name":"Activate a component draft","isWebhook":false,"pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}~1activation/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Activate a component draft","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":"Activates an existing component draft by creating the corresponding content type (when present),"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"component, and variants, then permanently removes the draft from storage."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Activation is a one-way operation — once successful the draft is no longer retrievable."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When activation availability is omitted, the endpoint falls back to the draft's stored availability."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If neither activation input nor the stored draft defines site assignments, the component is created without site assignments."},"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":"componentDraftId","in":"path","schemaId":"schema_1309","description":"The component draft identifier.","required":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276"}],"pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}~1activation/post/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"environmentId","in":"query","schemaId":"schema_1309","description":"The environment identifier.","example":"main"}],"pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}~1activation/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/ActivateComponentDraftInput"},"text/json":{"schemaId":"components/schemas/ActivateComponentDraftInput"},"application/*+json":{"schemaId":"components/schemas/ActivateComponentDraftInput"}},"schemaId":"components/schemas/ActivateComponentDraftInput","pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}~1activation/post/requestBody","description":"Optional availability overrides and variant names to activate."}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/components/drafts/{componentDraftId}/activation","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[{"name":"componentDraftId","in":"path","required":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276","schemaId":"schema_1309"}],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1309"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ActivateComponentDraftInput"},"text/json":{"schemaId":"components/schemas/ActivateComponentDraftInput"},"application/*+json":{"schemaId":"components/schemas/ActivateComponentDraftInput"}},"responseCodes":["200","400","401","404"],"pointer":"/api/v1/components/drafts/{componentDraftId}/activation","href":"components/activatedraft","openApiOperationId":"ActivateDraft","summary":"Activate a component draft"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"schemaId":"components/schemas/ActivateComponentDraftInput","mediaTypes":["application/json","text/json","application/*+json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ActivateComponentDraftInput"},"text/json":{"schemaId":"components/schemas/ActivateComponentDraftInput"},"application/*+json":{"schemaId":"components/schemas/ActivateComponentDraftInput"}},"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/ActivateComponentDraftResult"}},"schemaId":"components/schemas/ActivateComponentDraftResult"},{"code":"400","description":"One or more validation errors occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}~1activation/post/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}~1activation/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~1components~1drafts~1{componentDraftId}~1activation/post/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}~1activation/post/responses/401/content/application~1json/example"]},{"code":"404","description":"Component draft not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}~1activation/post/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}~1activation/post/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1components~1drafts~1{componentDraftId}~1activation/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ActivateComponentDraftResult","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ActivateComponentDraftResult"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}~1activation/post/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}~1activation/post/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}~1activation/post/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}~1activation/post/responses/401/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}~1activation/post/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1{componentDraftId}~1activation/post/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/activatedraft"}],"panels":[]}]},"httpPath":"/api/v1/components/drafts/{componentDraftId}/activation"},{"label":"Generate a component draft suggestion","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/components-api/components/createdraftsuggestion","routeSlug":"/sai/components-api/components/createdraftsuggestion","metadata":{"seo":{"title":"Generate a component draft suggestion","description":"Generates a component draft suggestion from a natural-language prompt."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"CreateDraftSuggestion","name":"Generate a component draft suggestion","isWebhook":false,"pointer":"/paths/~1api~1v1~1components~1drafts~1suggestions/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Generate a component draft suggestion","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Generates a component draft suggestion from a natural-language prompt."},{"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_1309","description":"The environment identifier. Defaults to \"main\". Currently only \"main\" is supported.","example":"main"}],"pointer":"/paths/~1api~1v1~1components~1drafts~1suggestions/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/CreateDraftSuggestionInput"},"text/json":{"schemaId":"components/schemas/CreateDraftSuggestionInput"},"application/*+json":{"schemaId":"components/schemas/CreateDraftSuggestionInput"}},"schemaId":"components/schemas/CreateDraftSuggestionInput","pointer":"/paths/~1api~1v1~1components~1drafts~1suggestions/post/requestBody","description":"The prompt describing the desired component."}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/components/drafts/suggestions","servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"environmentId","in":"query","example":"main","schemaId":"schema_1309"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"Bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateDraftSuggestionInput"},"text/json":{"schemaId":"components/schemas/CreateDraftSuggestionInput"},"application/*+json":{"schemaId":"components/schemas/CreateDraftSuggestionInput"}},"responseCodes":["200","400","401"],"pointer":"/api/v1/components/drafts/suggestions","href":"components/createdraftsuggestion","openApiOperationId":"CreateDraftSuggestion","summary":"Generate a component draft suggestion"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/authoring","description":"Production server"}],"schemaId":"components/schemas/CreateDraftSuggestionInput","mediaTypes":["application/json","text/json","application/*+json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateDraftSuggestionInput"},"text/json":{"schemaId":"components/schemas/CreateDraftSuggestionInput"},"application/*+json":{"schemaId":"components/schemas/CreateDraftSuggestionInput"}},"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/DraftSuggestion"}},"schemaId":"components/schemas/DraftSuggestion"},{"code":"400","description":"One or more validation errors occurred","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1suggestions/post/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1suggestions/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~1components~1drafts~1suggestions/post/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1suggestions/post/responses/401/content/application~1json/example"]}],"pointer":"/paths/~1api~1v1~1components~1drafts~1suggestions/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/DraftSuggestion","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/DraftSuggestion"}}},{"code":"400","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1suggestions/post/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1suggestions/post/responses/400/content/application~1json/example"]}}},{"code":"401","schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1suggestions/post/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProblemDetails","exampleIds":["paths/~1api~1v1~1components~1drafts~1suggestions/post/responses/401/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/createdraftsuggestion"}],"panels":[]}]},"httpPath":"/api/v1/components/drafts/suggestions"}],"content":{"contentType":"group","meta":{"name":"Components"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Components","showPageActions":true},{"nodeType":"markdoc","content":"The Components API lets you manage components and component drafts."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v1/components/drafts/{componentDraftId}","summary":"Retrieve a component draft","prefix":{"name":"get","color":"get"},"badges":[],"link":"/components/retrievedraft","deprecated":false},{"title":"/api/v1/components/drafts/{componentDraftId}","summary":"Update a component draft","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/components/patchdraft","deprecated":false},{"title":"/api/v1/components/drafts/{componentDraftId}","summary":"Update a component draft","prefix":{"name":"put","color":"put"},"badges":[],"link":"/components/updatedraft","deprecated":false},{"title":"/api/v1/components/drafts/{componentDraftId}","summary":"Delete a component draft","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/components/deletedraft","deprecated":false},{"title":"/api/v1/components/drafts","summary":"List component drafts","prefix":{"name":"get","color":"get"},"badges":[],"link":"/components/listdrafts","deprecated":false},{"title":"/api/v1/components/drafts","summary":"Create a component draft","prefix":{"name":"post","color":"post"},"badges":[],"link":"/components/createdraft","deprecated":false},{"title":"/api/v1/components","summary":"List components","prefix":{"name":"get","color":"get"},"badges":[],"link":"/components/listcomponents","deprecated":false},{"title":"/api/v1/components","summary":"Create a component","prefix":{"name":"post","color":"post"},"badges":[],"link":"/components/createcomponent","deprecated":false},{"title":"/api/v1/components/summaries","summary":"List component summaries","prefix":{"name":"get","color":"get"},"badges":[],"link":"/components/listcomponentsummaries","deprecated":false},{"title":"/api/v1/components/{componentId}","summary":"Retrieve a component","prefix":{"name":"get","color":"get"},"badges":[],"link":"/components/retrievecomponent","deprecated":false},{"title":"/api/v1/components/{componentId}","summary":"Update a component","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/components/updatecomponent","deprecated":false},{"title":"/api/v1/components/{componentId}/metadata","summary":"Retrieve component metadata","prefix":{"name":"get","color":"get"},"badges":[],"link":"/components/retrievecomponentmetadata","deprecated":false},{"title":"/api/v1/components/{componentId}/variant/{componentVariantId}/metadata","summary":"Retrieve component variant metadata by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/components/retrievecomponentvariantmetadata","deprecated":false},{"title":"/api/v1/components/{componentId}/sites","summary":"Get sites where specified component is allowed","prefix":{"name":"get","color":"get"},"badges":[],"link":"/components/retrievesitesbycomponentid","deprecated":false},{"title":"/api/v1/components/drafts/{id}/model-suggestion","summary":"Generate a draft content type suggestion","prefix":{"name":"post","color":"post"},"badges":[],"link":"/components/createdraftmodelsuggestion","deprecated":false},{"title":"/api/v1/components/drafts/{componentDraftId}/activation","summary":"Activate a component draft","prefix":{"name":"post","color":"post"},"badges":[],"link":"/components/activatedraft","deprecated":false},{"title":"/api/v1/components/drafts/suggestions","summary":"Generate a component draft suggestion","prefix":{"name":"post","color":"post"},"badges":[],"link":"/components/createdraftsuggestion","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/ActivateComponentDraftInput":{"id":"components/schemas/ActivateComponentDraftInput","kind":"json-schema","title":"ActivateComponentDraftInput","data":{"required":["variantNames"],"type":"object","properties":{"availability":{"$ref":"#/components/schemas/AvailabilityInput"},"variantNames":{"type":"array","items":{"type":"string"},"description":"The names of the draft variants that should be activated.","example":["Default","Dark"]}},"additionalProperties":false,"description":"Input model for activating a component draft."}},"components/schemas/ActivateComponentDraftResult":{"id":"components/schemas/ActivateComponentDraftResult","kind":"json-schema","title":"ActivateComponentDraftResult","data":{"type":"object","properties":{"componentId":{"type":"string","description":"The identifier of the created component.","nullable":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276"},"contentModelId":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The identifier of the created content type, or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the draft had no content type definition."},"children":[]}]}]}],"nullable":true,"example":"2f34355e-c52d-450e-b1b9-d4e9cbe64af2"}},"additionalProperties":false,"description":"The result of a component draft activation."}},"components/schemas/AvailabilityInput":{"id":"components/schemas/AvailabilityInput","kind":"json-schema","title":"AvailabilityInput","data":{"type":"object","properties":{"sites":{"type":"array","items":{"type":"string"},"description":"The list of sites where the component will be assigned.","nullable":true,"example":["4f2d7c8b9e1a4f0d8f3c2b176a4e9d22","c1378a9fe2bd4e56a1c4d9f87b33a6c4"]},"placeholders":{"type":"array","items":{"type":"string"},"description":"The list of placeholders where the component can be used.","nullable":true,"example":["4f2d7c8b9e1a4f0d8f3c2b176a4e9d22","c1378a9fe2bd4e56a1c4d9f87b33a6c4"]},"pageModels":{"type":"array","items":{"type":"string"},"description":"The list of allowed page models.","nullable":true,"example":["4f2d7c8b9e1a4f0d8f3c2b176a4e9d22","c1378a9fe2bd4e56a1c4d9f87b33a6c4"]}},"additionalProperties":false,"description":"Represents the availability constraints for a component, specifying which sites, placeholders, and page models the component can be used with."}},"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/Component":{"id":"components/schemas/Component","kind":"json-schema","title":"Component","data":{"type":"object","properties":{"id":{"type":"string","nullable":true,"description":"The identifier of the component.","example":"2492bac4-da07-4c86-87f0-9873d40e2276"},"name":{"type":"string","nullable":true,"description":"The name of the component.","example":"Hero Banner"},"displayName":{"type":"string","nullable":true,"description":"The component displayName.","example":"Banner"},"systemName":{"type":"string","nullable":true,"description":"The component system name.","example":"HeroBanner"},"description":{"type":"string","nullable":true,"description":"The component description.","example":"A promo component is a content block designed to showcase promotions using a combination of text and visuals"},"category":{"$ref":"#/components/schemas/ComponentCategory"},"icon":{"type":"string","nullable":true,"description":"The component icon URL.","example":"https://xmc-instance.sitecore-staging.cloud/-/icon/SXA_MDI/16x16/Promo.png"},"datasourceTemplateField":{"type":"string","nullable":true,"description":"Datasource template item path.","example":"/sitecore/templates/Feature/Promos"},"modelId":{"type":"string","nullable":true,"description":"The content type identifier.","example":"/sitecore/templates/Feature/Promos"},"renderingParameters":{"type":"object","additionalProperties":{"type":"string"},"nullable":true,"description":"The component rendering parameters.","example":{"ButtonText":"Click me!"}},"settings":{"type":"object","additionalProperties":{"type":"string"},"nullable":true,"description":"The component settings.","example":{"IsRenderingsWithDynamicPlaceholders":"true","RandomNumber":"10"}},"variants":{"type":"array","items":{"$ref":"#/components/schemas/ComponentVariant"},"nullable":true,"description":"The component variants.","example":[{"name":"Default","id":"2492bac4-da07-4c86-87f0-9873d40e2276","siteId":"497f6eca-6276-4993-bfeb-53cbbbba6f08"},{"name":"Advanced","id":"2f34355e-c52d-450e-b1b9-d4e9cbe64af2","siteId":"497f6eca-6276-4993-bfeb-53cbbbba6f08"}]},"system":{"$ref":"#/components/schemas/System"},"type":{"$ref":"#/components/schemas/ComponentType"}},"additionalProperties":false,"description":"The Component entity."}},"components/schemas/ComponentAvailability":{"id":"components/schemas/ComponentAvailability","kind":"json-schema","title":"ComponentAvailability","data":{"type":"object","properties":{"sites":{"type":"array","items":{"$ref":"#/components/schemas/Site"},"description":"List of sites the component is assigned to.","nullable":true},"pageModels":{"type":"array","items":{"$ref":"#/components/schemas/BaseContentModel"},"description":"The content types where component is allowed.","nullable":true}},"additionalProperties":false,"description":"The component availability model"}},"components/schemas/ComponentCategory":{"id":"components/schemas/ComponentCategory","kind":"json-schema","title":"ComponentCategory","data":{"type":"object","properties":{"id":{"type":"string","nullable":true,"description":"The category identifier","example":"ae070691-099d-4081-856c-4c4a7e3543df"},"name":{"type":"string","nullable":true,"description":"The category name","example":"Page Content"},"path":{"type":"string","nullable":true,"description":"The path to category item","example":"/sitecore/content/Tenant/Site/Home/Categories/Page-Content"}},"additionalProperties":false}},"components/schemas/ComponentCategoryInput":{"id":"components/schemas/ComponentCategoryInput","kind":"json-schema","title":"ComponentCategoryInput","data":{"type":"object","properties":{"id":{"type":"string","description":"The category identifier.","nullable":true,"example":"ae070691-099d-4081-856c-4c4a7e3543df"},"name":{"maxLength":50,"minLength":0,"pattern":"^(?![\\s-])[a-zA-Z0-9_\\s-]*(?<!\\s)$","type":"string","description":"The category name. Letters, numbers, spaces, underscores, and hyphens only.","nullable":true,"example":"Page Content"}},"additionalProperties":false,"description":"Details of the component category."}},"components/schemas/ComponentDraft":{"id":"components/schemas/ComponentDraft","kind":"json-schema","title":"ComponentDraft","data":{"type":"object","properties":{"id":{"type":"string","description":"The identifier of the component draft.","nullable":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276"},"name":{"type":"string","description":"The name of the component draft.","nullable":true,"example":"Hero Banner"},"displayName":{"type":"string","description":"The component draft display name.","nullable":true,"example":"Banner"},"description":{"type":"string","description":"The component draft description.","nullable":true,"example":"A promo component is a content block designed to showcase promotions using a combination of text and visuals"},"category":{"$ref":"#/components/schemas/ComponentCategory"},"modelId":{"type":"string","description":"The content type identifier.","nullable":true,"example":"dfed4457-d760-457a-bec1-c0dccdc44381"},"renderingParameters":{"type":"object","additionalProperties":{"type":"string"},"description":"The component draft rendering parameters.","nullable":true,"example":{"ButtonText":"Click me!"}},"settings":{"type":"object","additionalProperties":{"type":"string"},"description":"The component draft settings.","nullable":true,"example":{"IsRenderingsWithDynamicPlaceholders":"true","RandomNumber":"10"}},"system":{"$ref":"#/components/schemas/ComponentSystem"},"contentModel":{"$ref":"#/components/schemas/ContentModelDraft"},"variants":{"type":"array","items":{"$ref":"#/components/schemas/ComponentVariantDraft"},"description":"The variant drafts associated with this component draft.","nullable":true},"type":{"$ref":"#/components/schemas/DraftType"},"availability":{"$ref":"#/components/schemas/ComponentDraftAvailabilityModel"}},"additionalProperties":false,"description":"The draft of a component."}},"components/schemas/ComponentDraftAvailabilityModel":{"id":"components/schemas/ComponentDraftAvailabilityModel","kind":"json-schema","title":"ComponentDraftAvailabilityModel","data":{"type":"object","properties":{"sites":{"type":"array","items":{"$ref":"#/components/schemas/Site"},"description":"The sites where the draft is available.","nullable":true},"placeholders":{"type":"array","items":{"$ref":"#/components/schemas/Placeholder"},"description":"The placeholders where the draft is available.","nullable":true},"pageModels":{"type":"array","items":{"$ref":"#/components/schemas/BaseContentModel"},"description":"The page models where the draft is available.","nullable":true}},"additionalProperties":false,"description":"The availability settings stored on a component draft."}},"components/schemas/ComponentMetadata":{"id":"components/schemas/ComponentMetadata","kind":"json-schema","title":"ComponentMetadata","data":{"type":"object","properties":{"id":{"type":"string","description":"The component identifier.","nullable":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276"},"name":{"type":"string","description":"The component name.","nullable":true,"example":"Promo"},"displayName":{"type":"string","description":"The component display name.","nullable":true,"example":"Promo"},"code":{"type":"string","description":"The component code.","nullable":true,"example":"const Greeting = () => <h1>Hello!</h1>;"},"renderingParameters":{"type":"array","items":{"$ref":"#/components/schemas/RenderingParameter"},"description":"Rendering parameters","nullable":true},"settings":{"type":"object","additionalProperties":{},"description":"Component settings.","nullable":true},"availability":{"$ref":"#/components/schemas/ComponentAvailability"}},"additionalProperties":false,"description":"The ComponentMetadata entity."}},"components/schemas/ComponentSummary":{"id":"components/schemas/ComponentSummary","kind":"json-schema","title":"ComponentSummary","data":{"type":"object","properties":{"id":{"type":"string","description":"The identifier of the component.","nullable":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276"},"name":{"type":"string","description":"The name of the component.","nullable":true,"example":"Hero Banner"},"displayName":{"type":"string","description":"The component display name.","nullable":true,"example":"Banner"},"systemName":{"type":"string","description":"The component system name.","nullable":true,"example":"HeroBanner"},"modelId":{"type":"string","description":"The identifier of the content type.","nullable":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"}},"additionalProperties":false,"description":"A lightweight API response model containing only the fields required\nfor list and sidebar scenarios where the full component payload would be excessive."}},"components/schemas/ComponentSystem":{"id":"components/schemas/ComponentSystem","kind":"json-schema","title":"ComponentSystem","data":{"type":"object","properties":{"createdAt":{"type":"string","description":"The component creation time.","nullable":true,"example":"2023-01-01T00:00:00Z"},"createdBy":{"type":"string","description":"The component creator.","nullable":true,"example":"sitecore\\admin"},"updatedAt":{"type":"string","description":"The component last updating time.","nullable":true,"example":"2023-01-01T00:00:00Z"},"updatedBy":{"type":"string","description":"The last component updater.","nullable":true,"example":"sitecore\\admin"}},"additionalProperties":false,"description":"Component system information."}},"components/schemas/ComponentType":{"id":"components/schemas/ComponentType","kind":"json-schema","title":"ComponentType","data":{"enum":["Code","Hosted"],"type":"string","description":"Specifies the type of a component based on its rendering template."}},"components/schemas/ComponentVariant":{"id":"components/schemas/ComponentVariant","kind":"json-schema","title":"ComponentVariant","data":{"type":"object","properties":{"id":{"type":"string","nullable":true,"description":"The component variant identifier.","example":"Default"},"name":{"type":"string","nullable":true,"description":"The component variant name.","example":"Default"},"displayName":{"type":"string","nullable":true,"description":"The component variant display name.","example":"Default"},"description":{"type":"string","nullable":true,"description":"The component variant description.","example":"Sample variant description"},"siteName":{"type":"string","nullable":true,"description":"The site name.","example":"skate-park"},"siteId":{"type":"string","nullable":true,"description":"The site identifier.","example":"497f6eca-6276-4993-bfeb-53cbbbba6f08"},"attributes":{"type":"object","additionalProperties":{},"nullable":true,"description":"The component variant attributes."}},"additionalProperties":false,"description":"The ComponentVariant entity."}},"components/schemas/ComponentVariantDraft":{"id":"components/schemas/ComponentVariantDraft","kind":"json-schema","title":"ComponentVariantDraft","data":{"type":"object","properties":{"name":{"pattern":"^[A-Za-z0-9_ -]+$","type":"string","description":"The variant name. Used as the unique key for add-or-replace operations.","nullable":true,"example":"Default"},"code":{"type":"string","description":"The variant code.","nullable":true,"example":"<Button>Click</Button>"}},"additionalProperties":false,"description":"A draft variant containing a name and its associated code."}},"components/schemas/ComponentVariantMetadata":{"id":"components/schemas/ComponentVariantMetadata","kind":"json-schema","title":"ComponentVariantMetadata","data":{"type":"object","properties":{"id":{"type":"string","description":"The component variant identifier.","nullable":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276"},"componentId":{"type":"string","description":"The component identifier.","nullable":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276"},"name":{"type":"string","description":"The component variant name.","nullable":true,"example":"Promo Ba"},"displayName":{"type":"string","description":"The component variant display name.","nullable":true,"example":"Promo"},"codeId":{"type":"string","description":"The component variant code identifier.","nullable":true,"example":"2492bac4-da07-4c86-87f0-9873d40e2276"},"code":{"type":"string","description":"The component variant code.","nullable":true,"example":"const Greeting = () => <h1>Hello!</h1>;"},"parsedCode":{"type":"string","description":"The parsed representation of the component variant code.","nullable":true,"example":"{\"type\":\"nextjs-pages\",\"code\":{\"type\":\"tsx\",\"content\":\"Hi\"},\"styles\":{\"type\":\"css-module\",\"content\":\"\"}}"}},"additionalProperties":false,"description":"The component variant metadata entity."}},"components/schemas/ContentModelDraft":{"id":"components/schemas/ContentModelDraft","kind":"json-schema","title":"ContentModelDraft","data":{"type":"object","properties":{"name":{"type":"string","description":"The content type draft name.","nullable":true,"example":"Promo"},"description":{"type":"string","description":"The description of the content type draft.","nullable":true,"example":"Draft content type"},"fieldGroups":{"type":"array","items":{"$ref":"#/components/schemas/FieldGroupDraft"},"description":"The content type draft field groups.","nullable":true}},"additionalProperties":false,"description":"The content type draft associated with component draft."}},"components/schemas/ContentModelFieldDraft":{"id":"components/schemas/ContentModelFieldDraft","kind":"json-schema","title":"ContentModelFieldDraft","data":{"type":"object","properties":{"name":{"type":"string","description":"The field draft name.","nullable":true,"example":"PromoText"},"type":{"type":"string","description":"The field draft type.","nullable":true,"example":"Single-Line Text"},"helperText":{"type":"string","description":"Help text for the field draft.","nullable":true,"example":"Helper Text"},"value":{"description":"The default value of the field draft. Accepts string or object types.","nullable":true,"type":"object","example":{"text":"Field Value Text"}},"source":{"type":"string","description":"The source of the field.","nullable":true,"example":"/sitecore/content/Tenant/Site/Home"},"sortOrder":{"type":"integer","description":"The sort order.","format":"int32","nullable":true,"example":1},"validationRules":{"type":"array","items":{"type":"string"},"description":"The validation rules assigned to the field as a list of validation rule item IDs.","nullable":true,"example":["59D4EE10-627C-4FD3-A964-61A88B092CBC","A76C1092-EE2E-4021-B9EE-21E541CDA1D7"]}},"additionalProperties":false,"description":"The content field draft."}},"components/schemas/CreateComponentDraftInput":{"id":"components/schemas/CreateComponentDraftInput","kind":"json-schema","title":"CreateComponentDraftInput","data":{"required":["name"],"type":"object","properties":{"name":{"maxLength":50,"minLength":0,"type":"string","description":"The component draft name.","example":"Promo"},"displayName":{"maxLength":50,"minLength":0,"type":"string","description":"The component draft display name.","nullable":true,"example":"Promo"},"category":{"$ref":"#/components/schemas/ComponentCategoryInput"},"iconUrl":{"type":"string","description":"The component draft icon URL.","nullable":true,"example":"/temp/iconcache/sxa_mdi/32x32/promo.png"},"renderingParameters":{"type":"array","items":{"$ref":"#/components/schemas/RenderingParameterInput"},"description":"The component draft rendering parameters.","nullable":true},"settings":{"type":"object","additionalProperties":{"type":"string"},"description":"The component draft settings.","nullable":true,"example":{"Sample":"10"}},"description":{"type":"string","description":"The component draft description.","nullable":true,"example":"Promo description"},"type":{"$ref":"#/components/schemas/DraftType"}},"additionalProperties":false,"description":"Create component draft input"}},"components/schemas/CreateComponentInput":{"id":"components/schemas/CreateComponentInput","kind":"json-schema","title":"CreateComponentInput","data":{"required":["category","name"],"type":"object","properties":{"name":{"maxLength":50,"minLength":0,"pattern":"^(?![\\s-])[a-zA-Z0-9_\\s-]*(?<!\\s)$","type":"string","description":"The component name. \nLetters, numbers, spaces, underscores, and hyphens only.","example":"Promo"},"displayName":{"maxLength":50,"minLength":0,"type":"string","description":"The component display name.","nullable":true,"example":"Promo"},"category":{"$ref":"#/components/schemas/ComponentCategoryInput"},"iconUrl":{"type":"string","description":"The component icon URL.","nullable":true,"example":"Office/32x32/window_dialog.png"},"modelId":{"type":"string","description":"The content type ID.","nullable":true,"example":"dfed4457-d760-457a-bec1-c0dccdc44381"},"renderingParameters":{"type":"array","items":{"$ref":"#/components/schemas/RenderingParameterInput"},"description":"The component rendering parameters.","nullable":true},"settings":{"type":"object","additionalProperties":{"type":"string"},"description":"The component settings.","nullable":true,"example":{"IsRenderingsWithDynamicPlaceholders":"true","RandomNumber":"10"}},"description":{"type":"string","description":"The component description.","nullable":true,"example":"This is a promo component."},"availability":{"$ref":"#/components/schemas/AvailabilityInput"}},"additionalProperties":false,"description":"Create component input"}},"components/schemas/CreateDraftModelSuggestionInput":{"id":"components/schemas/CreateDraftModelSuggestionInput","kind":"json-schema","title":"CreateDraftModelSuggestionInput","data":{"type":"object","properties":{"atoms":{"type":"string","description":"Raw atoms payload from Rendering Host, representing small reusable UI building blocks.","nullable":true,"example":"<button class=\"btn btn-primary\">Submit</button>"}},"additionalProperties":false,"description":"Input for generating a draft content type suggestion."}},"components/schemas/CreateDraftSuggestionInput":{"id":"components/schemas/CreateDraftSuggestionInput","kind":"json-schema","title":"CreateDraftSuggestionInput","data":{"required":["prompt"],"type":"object","properties":{"prompt":{"maxLength":1000,"minLength":0,"type":"string","description":"A natural-language description of the component to generate a suggestion for.\nMust be between 5 and 1000 characters.","example":"A full-width banner with a background image, headline, subtext, and a call-to-action button"}},"additionalProperties":false,"description":"Input for generating a component draft suggestion."}},"components/schemas/DraftSuggestion":{"id":"components/schemas/DraftSuggestion","kind":"json-schema","title":"DraftSuggestion","data":{"type":"object","properties":{"name":{"type":"string","description":"The suggested system name of the component, formatted in PascalCase without spaces.","nullable":true,"example":"HeroBanner"},"displayName":{"type":"string","description":"The human-readable display name of the component.","nullable":true,"example":"Hero Banner"},"category":{"type":"string","description":"The suggested category for the component draft.","nullable":true,"example":"Page Content"},"description":{"type":"string","description":"A generated description summarising the component's purpose and content structure.","nullable":true,"example":"A full-width banner section featuring a background image, headline, subtext, and a call-to-action button."}},"additionalProperties":false,"description":"An AI-generated suggestion for a component draft."}},"components/schemas/DraftType":{"id":"components/schemas/DraftType","kind":"json-schema","title":"DraftType","data":{"enum":["Code","Hosted"],"type":"string","description":"Specifies the delivery model of a component draft."}},"components/schemas/EditingControl":{"id":"components/schemas/EditingControl","kind":"json-schema","title":"EditingControl","data":{"type":"object","properties":{"id":{"type":"string","nullable":true,"description":"The editing control identifier.","example":"{18293E6E-708E-4B15-84C3-AE52CC17A1}"},"name":{"type":"string","nullable":true,"description":"The editing control name.","example":"Spacing"},"displayName":{"type":"string","nullable":true,"description":"The editing control display name.","example":"Spacing"},"type":{"type":"string","nullable":true,"description":"The editing control type.","example":"icon-button-group-check"},"tooltip":{"type":"string","nullable":true,"description":"The editing control tooltip.","example":"Use this control to adjust the spacing of your component."},"values":{"type":"array","items":{"$ref":"#/components/schemas/EditingControlValue"},"nullable":true}},"additionalProperties":false}},"components/schemas/EditingControlInput":{"id":"components/schemas/EditingControlInput","kind":"json-schema","title":"EditingControlInput","data":{"type":"object","properties":{"type":{"type":"string","description":"The control type.","nullable":true,"example":"Single-Line Text"},"value":{"type":"string","description":"The control value.","nullable":true,"example":"Placeholder text"}},"additionalProperties":false,"description":"The rendering parameter editing control input."}},"components/schemas/EditingControlValue":{"id":"components/schemas/EditingControlValue","kind":"json-schema","title":"EditingControlValue","data":{"type":"object","properties":{"id":{"type":"string","nullable":true,"description":"The editing control value identifier.","example":"{18293E6E-708E-4B15-84C3-AE52CC17A1EE}"},"name":{"type":"string","nullable":true,"description":"The editing control value name.","example":"Indent top"},"icon":{"type":"string","nullable":true,"description":"The editing control value icon.","example":"add-spacing-top"},"value":{"type":"string","nullable":true,"description":"The editing control value.","example":"indent-top"},"tooltip":{"type":"string","nullable":true,"description":"The editing control tooltip.","example":"Top spacing"}},"additionalProperties":false}},"components/schemas/FieldGroupDraft":{"id":"components/schemas/FieldGroupDraft","kind":"json-schema","title":"FieldGroupDraft","data":{"type":"object","properties":{"name":{"type":"string","description":"The name of the field group.","nullable":true,"example":"GroupName"},"sortOrder":{"type":"integer","description":"The sort order.","format":"int32","nullable":true,"example":1},"fields":{"type":"array","items":{"$ref":"#/components/schemas/ContentModelFieldDraft"},"description":"The content type draft fields.","nullable":true}},"additionalProperties":false,"description":"The field group draft"}},"components/schemas/Placeholder":{"id":"components/schemas/Placeholder","kind":"json-schema","title":"Placeholder","data":{"type":"object","properties":{"id":{"type":"string","nullable":true,"description":"The identifier of the placeholder","example":"6f9619ff-8b86-d011-b42d-00c04fc964ff"},"name":{"type":"string","nullable":true,"description":"The name of the placeholder","example":"Main Content"},"placeholderKey":{"type":"string","nullable":true,"description":"The placeholder key.","example":"main-content"}},"additionalProperties":false}},"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/RenderingParameter":{"id":"components/schemas/RenderingParameter","kind":"json-schema","title":"RenderingParameter","data":{"type":"object","properties":{"name":{"type":"string","nullable":true,"description":"The rendering parameter name","example":"styles"},"displayName":{"type":"string","nullable":true,"description":"The rendering parameter display name","example":"Styling"},"editingControls":{"type":"array","items":{"$ref":"#/components/schemas/EditingControl"},"nullable":true}},"additionalProperties":false}},"components/schemas/RenderingParameterInput":{"id":"components/schemas/RenderingParameterInput","kind":"json-schema","title":"RenderingParameterInput","data":{"required":["editingControl","name"],"type":"object","properties":{"name":{"maxLength":50,"minLength":0,"type":"string","description":"The parameter name.","example":"Promo"},"displayName":{"maxLength":50,"minLength":0,"type":"string","description":"The parameter display name.","nullable":true,"example":"Promo"},"editingControl":{"$ref":"#/components/schemas/EditingControlInput"}},"additionalProperties":false,"description":"Create rendering parameter input"}},"components/schemas/ReplaceComponentDraftInput":{"id":"components/schemas/ReplaceComponentDraftInput","kind":"json-schema","title":"ReplaceComponentDraftInput","data":{"required":["name"],"type":"object","properties":{"name":{"maxLength":50,"minLength":0,"type":"string","description":"The component draft name.","example":"Promo"},"displayName":{"maxLength":50,"minLength":0,"type":"string","description":"The component draft display name. Falls back to name when empty.","nullable":true,"example":"Promo"},"description":{"type":"string","description":"The component draft description.","nullable":true,"example":"Promo description"},"category":{"$ref":"#/components/schemas/ComponentCategoryInput"},"modelId":{"type":"string","description":"The content type identifier.","nullable":true,"example":"ae070691-099d-4081-856c-4c4a7e3543df"},"renderingParameters":{"type":"array","items":{"$ref":"#/components/schemas/RenderingParameterInput"},"description":"The rendering parameters. Replaces the entire stored list.\nSend an empty array to clear all rendering parameters.","nullable":true},"settings":{"type":"object","additionalProperties":{"type":"string"},"description":"Other component draft settings. Replaces the entire stored dictionary.\nSend an empty object to clear all settings.","nullable":true},"contentModel":{"$ref":"#/components/schemas/ContentModelDraft"},"variants":{"type":"array","items":{"$ref":"#/components/schemas/ComponentVariantDraft"},"description":"The full variant list. Replaces the entire stored variants dictionary.\nVariants not present in this list are removed.\nSend an empty array to clear all variants. Variant names must be unique.","nullable":true},"availability":{"$ref":"#/components/schemas/AvailabilityInput"}},"additionalProperties":false,"description":"Input for a full replacement (PUT) of a component draft."}},"components/schemas/ResourceLink":{"id":"components/schemas/ResourceLink","kind":"json-schema","title":"ResourceLink","data":{"type":"object","properties":{"href":{"type":"string","description":"The relative URL of the linked resource.","nullable":true,"example":"/api/v1/sites/497f6eca-6276-4993-bfeb-53cbbbba6f08"}},"additionalProperties":false,"description":"A single hypermedia link (RFC 8288)."}},"components/schemas/Site":{"id":"components/schemas/Site","kind":"json-schema","title":"Site","data":{"type":"object","properties":{"id":{"type":"string","description":"The identifier of the site.","nullable":true,"example":"497f6eca-6276-4993-bfeb-53cbbbba6f08"},"name":{"type":"string","description":"The name of the site.","nullable":true,"example":"skate-park"},"displayName":{"type":"string","description":"The display name of the site.","nullable":true,"example":"Skate Park Website"},"links":{"$ref":"#/components/schemas/SiteLinks"}},"additionalProperties":false,"description":"Site short information."}},"components/schemas/SiteLinks":{"id":"components/schemas/SiteLinks","kind":"json-schema","title":"SiteLinks","data":{"type":"object","properties":{"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false,"description":"Hypermedia links associated with a Site resource."}},"components/schemas/System":{"id":"components/schemas/System","kind":"json-schema","title":"System","data":{"type":"object","properties":{"created":{"type":"string","nullable":true,"description":"Time of creation.","example":"2023-01-01T00:00:00Z"},"createdBy":{"type":"string","nullable":true,"description":"Name of creator.","example":"sitecore admin"},"updated":{"type":"string","nullable":true,"description":"Time of last update.","example":"2023-01-01T00:00:00Z"},"updatedBy":{"type":"string","nullable":true,"description":"The last  updater.","example":"sitecore admin"}},"additionalProperties":false}},"components/schemas/UpdateComponentDraftInput":{"id":"components/schemas/UpdateComponentDraftInput","kind":"json-schema","title":"UpdateComponentDraftInput","data":{"type":"object","properties":{"name":{"type":"string","description":"Component draft name.","nullable":true,"example":"Promo"},"displayName":{"type":"string","description":"Component draft display name.","nullable":true,"example":"Promo"},"description":{"type":"string","description":"Component draft description.","nullable":true,"example":"A promo component is a content block designed to showcase promotions using a combination of text and visuals"},"category":{"$ref":"#/components/schemas/ComponentCategoryInput"},"modelId":{"type":"string","description":"Content type identifier.","nullable":true,"example":"d4e5f6a7-b8c9-0123-4567-89abcdef0123"},"settings":{"type":"object","additionalProperties":{"type":"string"},"description":"Other component draft properties.","nullable":true},"contentModel":{"$ref":"#/components/schemas/ContentModelDraft"},"variants":{"type":"array","items":{"$ref":"#/components/schemas/ComponentVariantDraft"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Variant drafts to add or replace by name."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"list","attrs":{"type":"bullet"}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"item","attrs":{}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"description","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Omit or pass "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — existing variants are left unchanged."},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"item","attrs":{}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"description","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Empty array "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"[]"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — all existing variants are removed."},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"item","attrs":{}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"description","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Non-empty array — only the named variants are added or updated; variants not present in the list are preserved."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Variant names must be unique."},"children":[]}]}]}],"nullable":true},"availability":{"$ref":"#/components/schemas/AvailabilityInput"}},"additionalProperties":false,"description":"Update component draft input."}},"components/schemas/UpdateComponentInput":{"id":"components/schemas/UpdateComponentInput","kind":"json-schema","title":"UpdateComponentInput","data":{"type":"object","properties":{"name":{"maxLength":50,"minLength":0,"pattern":"^(?![\\s-])[a-zA-Z0-9_\\s-]*(?<!\\s)$","type":"string","description":"Component name. Letters, numbers, spaces, underscores, and hyphens only.","nullable":true,"example":"MyComponent"},"displayName":{"type":"string","description":"Component display name.","nullable":true,"example":"My Component"},"description":{"type":"string","description":"Component description.","nullable":true,"example":"This is my component description."},"modelId":{"type":"string","description":"content type identifier.","nullable":true,"example":"dfed4457-d760-457a-bec1-c0dccdc44381"},"settings":{"type":"object","additionalProperties":{"type":"string"},"description":"Other component properties.","nullable":true},"availability":{"$ref":"#/components/schemas/AvailabilityInput"}},"additionalProperties":false,"description":"Update component input"}},"schema_1309":{"kind":"json-schema","data":{"type":"string"},"id":"schema_1309"},"schema_1310":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/ComponentCategory"}},"id":"schema_1310"},"schema_1311":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/Component"}},"id":"schema_1311"},"schema_1312":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/ComponentDraft"}},"id":"schema_1312"},"schema_1313":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/ComponentSummary"}},"id":"schema_1313"},"schema_1314":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/Site"}},"id":"schema_1314"}},"exampleStore":{"paths/~1api~1v1~1component-categories/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~1component-categories/get/responses/400/content/application~1json/example"},"paths/~1api~1v1~1component-categories/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~1component-categories/get/responses/401/content/application~1json/example"},"paths/~1api~1v1~1component-categories~1{category}~1components/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~1component-categories~1{category}~1components/get/responses/400/content/application~1json/example"},"paths/~1api~1v1~1component-categories~1{category}~1components/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~1component-categories~1{category}~1components/get/responses/401/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts~1{componentDraftId}/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~1components~1drafts~1{componentDraftId}/get/responses/400/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts~1{componentDraftId}/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~1components~1drafts~1{componentDraftId}/get/responses/401/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts~1{componentDraftId}/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~1components~1drafts~1{componentDraftId}/get/responses/404/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts~1{componentDraftId}/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~1components~1drafts~1{componentDraftId}/patch/responses/400/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts~1{componentDraftId}/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~1components~1drafts~1{componentDraftId}/patch/responses/401/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts~1{componentDraftId}/patch/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~1components~1drafts~1{componentDraftId}/patch/responses/404/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts~1{componentDraftId}/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~1components~1drafts~1{componentDraftId}/put/responses/400/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts~1{componentDraftId}/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~1components~1drafts~1{componentDraftId}/put/responses/401/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts~1{componentDraftId}/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~1components~1drafts~1{componentDraftId}/put/responses/404/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts~1{componentDraftId}/delete/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~1components~1drafts~1{componentDraftId}/delete/responses/400/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts~1{componentDraftId}/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~1components~1drafts~1{componentDraftId}/delete/responses/401/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts~1{componentDraftId}/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~1components~1drafts~1{componentDraftId}/delete/responses/404/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts/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~1components~1drafts/get/responses/400/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts/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~1components~1drafts/get/responses/401/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts/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~1components~1drafts/post/responses/400/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts/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~1components~1drafts/post/responses/401/content/application~1json/example"},"paths/~1api~1v1~1components/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~1components/get/responses/400/content/application~1json/example"},"paths/~1api~1v1~1components/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~1components/get/responses/401/content/application~1json/example"},"paths/~1api~1v1~1components/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~1components/post/responses/400/content/application~1json/example"},"paths/~1api~1v1~1components/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~1components/post/responses/401/content/application~1json/example"},"paths/~1api~1v1~1components/post/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~1components/post/responses/404/content/application~1json/example"},"paths/~1api~1v1~1components~1summaries/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~1components~1summaries/get/responses/400/content/application~1json/example"},"paths/~1api~1v1~1components~1summaries/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~1components~1summaries/get/responses/401/content/application~1json/example"},"paths/~1api~1v1~1components~1{componentId}/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~1components~1{componentId}/get/responses/400/content/application~1json/example"},"paths/~1api~1v1~1components~1{componentId}/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~1components~1{componentId}/get/responses/401/content/application~1json/example"},"paths/~1api~1v1~1components~1{componentId}/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~1components~1{componentId}/get/responses/404/content/application~1json/example"},"paths/~1api~1v1~1components~1{componentId}/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~1components~1{componentId}/patch/responses/400/content/application~1json/example"},"paths/~1api~1v1~1components~1{componentId}/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~1components~1{componentId}/patch/responses/401/content/application~1json/example"},"paths/~1api~1v1~1components~1{componentId}/patch/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~1components~1{componentId}/patch/responses/404/content/application~1json/example"},"paths/~1api~1v1~1components~1{componentId}~1metadata/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~1components~1{componentId}~1metadata/get/responses/400/content/application~1json/example"},"paths/~1api~1v1~1components~1{componentId}~1metadata/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~1components~1{componentId}~1metadata/get/responses/401/content/application~1json/example"},"paths/~1api~1v1~1components~1{componentId}~1metadata/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~1components~1{componentId}~1metadata/get/responses/404/content/application~1json/example"},"paths/~1api~1v1~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/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~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/get/responses/400/content/application~1json/example"},"paths/~1api~1v1~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/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~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/get/responses/401/content/application~1json/example"},"paths/~1api~1v1~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/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~1components~1{componentId}~1variant~1{componentVariantId}~1metadata/get/responses/404/content/application~1json/example"},"paths/~1api~1v1~1components~1{componentId}~1sites/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~1components~1{componentId}~1sites/get/responses/400/content/application~1json/example"},"paths/~1api~1v1~1components~1{componentId}~1sites/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~1components~1{componentId}~1sites/get/responses/401/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts~1{id}~1model-suggestion/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~1components~1drafts~1{id}~1model-suggestion/post/responses/400/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts~1{id}~1model-suggestion/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~1components~1drafts~1{id}~1model-suggestion/post/responses/401/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts~1{id}~1model-suggestion/post/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~1components~1drafts~1{id}~1model-suggestion/post/responses/404/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts~1{componentDraftId}~1activation/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~1components~1drafts~1{componentDraftId}~1activation/post/responses/400/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts~1{componentDraftId}~1activation/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~1components~1drafts~1{componentDraftId}~1activation/post/responses/401/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts~1{componentDraftId}~1activation/post/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~1components~1drafts~1{componentDraftId}~1activation/post/responses/404/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts~1suggestions/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~1components~1drafts~1suggestions/post/responses/400/content/application~1json/example"},"paths/~1api~1v1~1components~1drafts~1suggestions/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~1components~1drafts~1suggestions/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/components-api/index.json?download"},{"url":"/_bundle/sai/components-api/index.yaml?download"}],"excludeFromSearch":false,"replayFeatures":{"graphql":false},"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Components API","description":"Use the SitecoreAI Components API to manage components, data sources, and component categories.\n\n This REST API lets you:\n\n - Manage components for a site, including its rendering parameters, and the editing controls that determine the appearance of the component in an editing interface such as the Page Builder.\n\n - Read and update data sources and read data source hierarchies for an environment.\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/components-api","routesMapping":{}}