{"items":[{"type":"link","label":"Agent API","link":"/sai/agent-api","routeSlug":"/sai/agent-api","content":{"contentType":"overview","meta":{"name":"Agent API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"index.json","url":"/_bundle/sai/agent-api/@v2.0/index.json?download"},{"kind":"download","label":"index.yaml","url":"/_bundle/sai/agent-api/@v2.0/index.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[{"kind":"externallink","title":"License","titleTranslationKey":"info.license","label":"Documentation License: 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/stream/ai-agent-api","description":"Production server"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Agent API (v2.0)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Agent API allows AI agents to take direct action in Sitecore through secure REST endpoints. It supports common digital experience tasks such as creating pages, adding components, and updating content."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"As part of Sitecore's "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/xmc/en/users/xm-cloud/integrating-sitecore-with-agentic-platforms.html"},"children":[{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"interoperability"},"children":[]}]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" approach, the Agent API allows agentic platforms and other connected systems to interact directly with Sitecore. When an AI agent receives a natural language request, it can call the appropriate Agent API endpoints to complete the task. For example, a request to create a new landing page might trigger an endpoint in Sitecore that automatically builds the page. If the AI agent performs an unintended action, you can use the job ID to revert it. Each operation is tracked to ensure safe rollback when needed."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"All Agent API actions follow the built-in security and approval rules in Sitecore, keeping work safe, traceable, and auditable."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"In addition to AI agent-driven workflows, developers can also use the REST API directly to interact with the following objects:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sites"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - retrieve and manage sites and their pages."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pages"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - create and manage pages and components."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Content"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - create and organize content items."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Components"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - retrieve and manage components and datasources."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Assets"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - upload and manage digital assets."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Environments"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - retrieve environment and language details."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Personalization"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - manage personalized content variants."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Jobs"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - view or revert job operations."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Brand kits"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - retrieve brand kits and their details."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Brand contexts"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - retrieve brand contexts, their metadata, folder and file trees, and content."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Briefs"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - retrieve brief types, generate and create briefs."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Experiments"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - create and update A/B tests on components on a page."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - retrieve flow definitions (A/B/n tests and personalizations) for a page and set up their variants."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note the following:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To use this REST API, you authenticate your API requests."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"All API requests are made in your production environment."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Agent API also powers the Sitecore Marketer MCP server, which uses these endpoints to perform agentic operations in Sitecore. Read more about the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/sai/en/users/sitecoreai/sitecore-marketer-mcp-server.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Marketer MCP server"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"sectionId":"/sai/agent-api"}],"sectionId":"/sai/agent-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). You can also register an OAuth app if your integration requires the OAuth 2.0 authorization code flow."},"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/agent-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/agent-api/section/authorization/create-an-automation-client"}],"sectionId":"/sai/agent-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/register-an-oauth-app-for-the-agent-api"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Register an OAuth app for the Agent API"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Agent API uses the OAuth 2.0 authorization code flow to securely authenticate requests from external applications."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Each application must have an OAuth app registration, which identifies the app and defines the parts of the Sitecore platform it can access."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you plan to register an OAuth app that uses the Agent API, you must submit a registration request to Sitecore Support and request the following scopes:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"xmcloud.cm:admin"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"personalize.exp:mng"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"personalize.tmpl:r"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"personalize.pos:mng"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ai.org.bri:r"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"co.briefs:r"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"co.briefs:w"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ai.org.brd:r"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ai.org.bri:w"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cmp.sites:read"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"platform.tenants:list"},"children":[]}]}]}]}]}],"sectionId":"/sai/agent-api/section/authorization/register-an-oauth-app-for-the-agent-api"}],"sectionId":"/sai/agent-api/section/authorization/register-an-oauth-app-for-the-agent-api"},{"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/agent-api/section/authorization/request-a-jwt"}],"sectionId":"/sai/agent-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/agent-api/section/authorization/include-the-jwt-in-the-request-header"}],"sectionId":"/sai/agent-api/section/authorization/include-the-jwt-in-the-request-header"}]}]}},{"type":"group","label":"Authorization","link":"/sai/agent-api/section/authorization","routeSlug":"/sai/agent-api/section/authorization","items":[{"type":"link","label":"Create an automation client","link":"/sai/agent-api/section/authorization/create-an-automation-client","routeSlug":"/sai/agent-api/section/authorization/create-an-automation-client","content":null},{"type":"link","label":"Register an OAuth app for the Agent API","link":"/sai/agent-api/section/authorization/register-an-oauth-app-for-the-agent-api","routeSlug":"/sai/agent-api/section/authorization/register-an-oauth-app-for-the-agent-api","content":null},{"type":"link","label":"Request a JWT","link":"/sai/agent-api/section/authorization/request-a-jwt","routeSlug":"/sai/agent-api/section/authorization/request-a-jwt","content":null},{"type":"link","label":"Include the JWT in the request header","link":"/sai/agent-api/section/authorization/include-the-jwt-in-the-request-header","routeSlug":"/sai/agent-api/section/authorization/include-the-jwt-in-the-request-header","content":null}],"content":null},{"type":"group","label":"Sites","link":"/sai/agent-api/sites","routeSlug":"/sai/agent-api/sites","items":[{"label":"List sites","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/sites/sites-get_sites_list","routeSlug":"/sai/agent-api/sites/sites-get_sites_list","metadata":{"seo":{"title":"List sites","description":"Retrieves a list of available sites with their basic information including name, display name, and URL."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"sites-get_sites_list","name":"List sites","isWebhook":false,"pointer":"/paths/~1api~1v1~1sites/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List sites","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 available sites with their basic information including name, display name, and URL."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1sites/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/sites","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/sites","href":"sites/sites-get_sites_list","openApiOperationId":"sites-get_sites_list","summary":"List sites"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListSitesResponse"}},"schemaId":"components/schemas/ListSitesResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1sites/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ListSitesResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListSitesResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/sites/sites-get_sites_list"}],"panels":[]}]},"httpPath":"/api/v1/sites"},{"label":"Retrieve the site details","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/sites/sites-get_site_details","routeSlug":"/sai/agent-api/sites/sites-get_site_details","metadata":{"seo":{"title":"Retrieve the site details","description":"Retrieves the details of a specific site including its ID, name, and root path."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"sites-get_site_details","name":"Retrieve the site details","isWebhook":false,"pointer":"/paths/~1api~1v1~1sites~1{siteId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve the site details","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves the details of a specific site including its  ID, name, and root path."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"siteId","in":"path","schemaId":"schema_1465","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the site. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_sites_list"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List sites"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"}],"pointer":"/paths/~1api~1v1~1sites~1{siteId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1sites~1{siteId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/sites/{siteId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"siteId","in":"path","required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301","schemaId":"schema_1465"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/sites/{siteId}","href":"sites/sites-get_site_details","openApiOperationId":"sites-get_site_details","summary":"Retrieve the site details"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SiteInformationResponse"}},"schemaId":"components/schemas/SiteInformationResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1sites~1{siteId}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/SiteInformationResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SiteInformationResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/sites/sites-get_site_details"}],"panels":[]}]},"httpPath":"/api/v1/sites/{siteId}"},{"label":"List pages of a site","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/sites/sites-get_all_pages_by_site","routeSlug":"/sai/agent-api/sites/sites-get_all_pages_by_site","metadata":{"seo":{"title":"List pages of a site","description":"Retrieves a list of pages for a specific site, including each page's ID and path. You can optionally filter the pages by language."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"sites-get_all_pages_by_site","name":"List pages of a site","isWebhook":false,"pointer":"/paths/~1api~1v1~1sites~1{siteName}~1pages/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List pages of a site","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 pages for a specific site, including each page's ID and path. You can optionally filter the pages by language."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"siteName","in":"path","schemaId":"schema_1466","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique name of the site. To get this name, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_sites_list"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List sites"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"skate-park"}],"pointer":"/paths/~1api~1v1~1sites~1{siteName}~1pages/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"language","in":"query","schemaId":"schema_1467","description":"The language code for filtering pages.","example":"en"}],"pointer":"/paths/~1api~1v1~1sites~1{siteName}~1pages/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1sites~1{siteName}~1pages/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/sites/{siteName}/pages","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"siteName","in":"path","required":true,"example":"skate-park","schemaId":"schema_1466"}],"query":[{"name":"language","in":"query","required":false,"example":"en","schemaId":"schema_1467"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/sites/{siteName}/pages","href":"sites/sites-get_all_pages_by_site","openApiOperationId":"sites-get_all_pages_by_site","summary":"List pages of a site"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1468"}},"schemaId":"schema_1468"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1sites~1{siteName}~1pages/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1468","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1468"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/sites/sites-get_all_pages_by_site"}],"panels":[]}]},"httpPath":"/api/v1/sites/{siteName}/pages"},{"label":"Retrieve a site ID from an item ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/sites/sites-get_site_id_from_item","routeSlug":"/sai/agent-api/sites/sites-get_site_id_from_item","metadata":{"seo":{"title":"Retrieve a site ID from an item ID","description":"Retrieves the site ID associated with a specific item ID. This is useful for determining which site an item belongs to."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"sites-get_site_id_from_item","name":"Retrieve a site ID from an item ID","isWebhook":false,"pointer":"/paths/~1api~1v1~1sites~1site-id-from-item~1{itemId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a site ID from an item ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves the site ID associated with a specific item ID. This is useful for determining which site an item belongs to."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"itemId","in":"path","schemaId":"schema_1469","description":"The unique identifier of the item. ","required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"}],"pointer":"/paths/~1api~1v1~1sites~1site-id-from-item~1{itemId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1sites~1site-id-from-item~1{itemId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/sites/site-id-from-item/{itemId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"itemId","in":"path","required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301","schemaId":"schema_1469"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/sites/site-id-from-item/{itemId}","href":"sites/sites-get_site_id_from_item","openApiOperationId":"sites-get_site_id_from_item","summary":"Retrieve a site ID from an item ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SiteIdFromItemResponse"}},"schemaId":"components/schemas/SiteIdFromItemResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1sites~1site-id-from-item~1{itemId}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/SiteIdFromItemResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SiteIdFromItemResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/sites/sites-get_site_id_from_item"}],"panels":[]}]},"httpPath":"/api/v1/sites/site-id-from-item/{itemId}"}],"content":{"contentType":"group","meta":{"name":"Sites"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Sites","showPageActions":true},{"nodeType":"markdoc","content":"The Sites API lets you retrieve all sites, retrieve details about a specific site, list pages of a site, and retrieve a site ID associated with an item ID."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v1/sites","summary":"List sites","prefix":{"name":"get","color":"get"},"badges":[],"link":"/sites/sites-get_sites_list","deprecated":false},{"title":"/api/v1/sites/{siteId}","summary":"Retrieve the site details","prefix":{"name":"get","color":"get"},"badges":[],"link":"/sites/sites-get_site_details","deprecated":false},{"title":"/api/v1/sites/{siteName}/pages","summary":"List pages of a site","prefix":{"name":"get","color":"get"},"badges":[],"link":"/sites/sites-get_all_pages_by_site","deprecated":false},{"title":"/api/v1/sites/site-id-from-item/{itemId}","summary":"Retrieve a site ID from an item ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/sites/sites-get_site_id_from_item","deprecated":false}]}]}]}]}},{"type":"group","label":"Pages","link":"/sai/agent-api/pages","routeSlug":"/sai/agent-api/pages","items":[{"label":"Create a page","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/pages/pages-create_page","routeSlug":"/sai/agent-api/pages/pages-create_page","metadata":{"seo":{"title":"Create a page","description":"Creates a new page using the specified template under the parent page. You can set field values and the language for the new page."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"pages-create_page","name":"Create a page","isWebhook":false,"pointer":"/paths/~1api~1v1~1pages~1create/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a page","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates a new page using the specified template under the parent page. You can set field values and the language for the new page."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1pages~1create/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreatePageRequest"}},"schemaId":"components/schemas/CreatePageRequest","pointer":"/paths/~1api~1v1~1pages~1create/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/pages/create","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreatePageRequest"}},"responseCodes":["201","422"],"pointer":"/api/v1/pages/create","href":"pages/pages-create_page","openApiOperationId":"pages-create_page","summary":"Create a page"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/CreatePageRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreatePageRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreatePageResponse"}},"schemaId":"components/schemas/CreatePageResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1pages~1create/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/CreatePageResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreatePageResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/pages/pages-create_page"}],"panels":[]}]},"httpPath":"/api/v1/pages/create"},{"label":"Add a language version to a page","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/pages/pages-add_language_to_page","routeSlug":"/sai/agent-api/pages/pages-add_language_to_page","metadata":{"seo":{"title":"Add a language version to a page","description":"Adds a new language version for an existing page. This allows you to have the same page content available in multiple languages."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"pages-add_language_to_page","name":"Add a language version to a page","isWebhook":false,"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1add-language/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add a language version to a page","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Adds a new language version for an existing page. This allows you to have the same page content available in multiple languages."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"pageId","in":"path","schemaId":"schema_1470","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page.To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"f0b81bcc-7388-46be-b109-6e73d1114470"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1add-language/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1add-language/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AddLanguageRequest"}},"schemaId":"components/schemas/AddLanguageRequest","pointer":"/paths/~1api~1v1~1pages~1{pageId}~1add-language/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/pages/{pageId}/add-language","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"pageId","in":"path","required":true,"example":"f0b81bcc-7388-46be-b109-6e73d1114470","schemaId":"schema_1470"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AddLanguageRequest"}},"responseCodes":["200","422"],"pointer":"/api/v1/pages/{pageId}/add-language","href":"pages/pages-add_language_to_page","openApiOperationId":"pages-add_language_to_page","summary":"Add a language version to a page"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/AddLanguageRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AddLanguageRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AddLanguageResponse"}},"schemaId":"components/schemas/AddLanguageResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1add-language/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/AddLanguageResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AddLanguageResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/pages/pages-add_language_to_page"}],"panels":[]}]},"httpPath":"/api/v1/pages/{pageId}/add-language"},{"label":"Add a component to a page","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/pages/pages-add_component_on_page","routeSlug":"/sai/agent-api/pages/pages-add_component_on_page","metadata":{"seo":{"title":"Add a component to a page","description":"Adds a component to a specific placeholder on a page. You can specify the component type, placeholder location, and configure its initial settings. Optionally, you can specify its position relative to an existing component."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"pages-add_component_on_page","name":"Add a component to a page","isWebhook":false,"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1components/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add a component to a page","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Adds a component to a specific placeholder on a page. You can specify the component type, placeholder location, and configure its initial settings. Optionally, you can specify its position relative to an existing component."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"pageId","in":"path","schemaId":"schema_1471","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"f0b81bcc-7388-46be-b109-6e73d1114470"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1components/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1components/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AddComponentRequest"}},"schemaId":"components/schemas/AddComponentRequest","pointer":"/paths/~1api~1v1~1pages~1{pageId}~1components/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/pages/{pageId}/components","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"pageId","in":"path","required":true,"example":"f0b81bcc-7388-46be-b109-6e73d1114470","schemaId":"schema_1471"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AddComponentRequest"}},"responseCodes":["201","422"],"pointer":"/api/v1/pages/{pageId}/components","href":"pages/pages-add_component_on_page","openApiOperationId":"pages-add_component_on_page","summary":"Add a component to a page"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/AddComponentRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AddComponentRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AddComponentResponse"}},"schemaId":"components/schemas/AddComponentResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1components/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/AddComponentResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AddComponentResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/pages/pages-add_component_on_page"}],"panels":[]}]},"httpPath":"/api/v1/pages/{pageId}/components"},{"label":"Retrieve components on a page","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/pages/pages-get_components_on_page","routeSlug":"/sai/agent-api/pages/pages-get_components_on_page","metadata":{"seo":{"title":"Retrieve components on a page","description":"Retrieves the components on a page."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"pages-get_components_on_page","name":"Retrieve components on a page","isWebhook":false,"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1components/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve components on a page","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves the components on a page."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"pageId","in":"path","schemaId":"schema_1472","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page from which to retrieve components. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"f0b81bcc-7388-46be-b109-6e73d1114470"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1components/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"language","in":"query","schemaId":"schema_1473","description":"The language code for filtering components.","example":"en"},{"name":"version","in":"query","schemaId":"schema_1474","description":"The version number of the page to retrieve components from.","example":1},{"name":"variantId","in":"query","schemaId":"schema_1475","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the  personalization or A/B/n test variant on the page. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://api-docs.sitecore.com/sai/agent-api/flow-definitions/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint. Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transpiledVariants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"variants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when available."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you provide this value, the endpoint returns components of the specified variant. If you omit this value, the endpoint returns components of the base page."},"children":[]}]}]}],"example":"8bd7a9ec96b8490f9b894e3866fefb79_2a5c1e8c8d244f569a44d6b28cbecb05"},{"name":"includeRenderingDetails","in":"query","schemaId":"schema_1476"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1components/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1components/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/pages/{pageId}/components","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"pageId","in":"path","required":true,"example":"f0b81bcc-7388-46be-b109-6e73d1114470","schemaId":"schema_1472"}],"query":[{"name":"language","in":"query","required":false,"example":"en","schemaId":"schema_1473"},{"name":"version","in":"query","required":false,"example":1,"schemaId":"schema_1474"},{"name":"variantId","in":"query","required":false,"example":"8bd7a9ec96b8490f9b894e3866fefb79_2a5c1e8c8d244f569a44d6b28cbecb05","schemaId":"schema_1475"},{"name":"includeRenderingDetails","in":"query","required":false,"schemaId":"schema_1476"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/pages/{pageId}/components","href":"pages/pages-get_components_on_page","openApiOperationId":"pages-get_components_on_page","summary":"Retrieve components on a page"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetPageComponentsResponse"}},"schemaId":"components/schemas/GetPageComponentsResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1components/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/GetPageComponentsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetPageComponentsResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/pages/pages-get_components_on_page"}],"panels":[]}]},"httpPath":"/api/v1/pages/{pageId}/components"},{"label":"Set the component datasource","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/pages/pages-set_component_datasource","routeSlug":"/sai/agent-api/pages/pages-set_component_datasource","metadata":{"seo":{"title":"Set the component datasource","description":"Sets the datasource for a specific component on a page. You can specify a new data source item or clear the existing one."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"pages-set_component_datasource","name":"Set the component datasource","isWebhook":false,"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1components~1{componentId}~1datasource/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Set the component datasource","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Sets the datasource for a specific component on a page. You can specify a new data source item or clear the existing one."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"pageId","in":"path","schemaId":"schema_1470","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page.To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"f0b81bcc-7388-46be-b109-6e73d1114470"},{"name":"componentId","in":"path","schemaId":"schema_1477","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the component on the page. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/pages-get_components_on_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieve components on a page"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"86a03271-dff4-470a-92bd-b68c67de2e25"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1components~1{componentId}~1datasource/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1components~1{componentId}~1datasource/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/SetComponentDatasourceRequest"}},"schemaId":"components/schemas/SetComponentDatasourceRequest","pointer":"/paths/~1api~1v1~1pages~1{pageId}~1components~1{componentId}~1datasource/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/pages/{pageId}/components/{componentId}/datasource","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"pageId","in":"path","required":true,"example":"f0b81bcc-7388-46be-b109-6e73d1114470","schemaId":"schema_1470"},{"name":"componentId","in":"path","required":true,"example":"86a03271-dff4-470a-92bd-b68c67de2e25","schemaId":"schema_1477"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/SetComponentDatasourceRequest"}},"responseCodes":["200","422"],"pointer":"/api/v1/pages/{pageId}/components/{componentId}/datasource","href":"pages/pages-set_component_datasource","openApiOperationId":"pages-set_component_datasource","summary":"Set the component datasource"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/SetComponentDatasourceRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/SetComponentDatasourceRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SetComponentDatasourceResponse"}},"schemaId":"components/schemas/SetComponentDatasourceResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1components~1{componentId}~1datasource/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/SetComponentDatasourceResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SetComponentDatasourceResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/pages/pages-set_component_datasource"}],"panels":[]}]},"httpPath":"/api/v1/pages/{pageId}/components/{componentId}/datasource"},{"label":"Search for pages on a site","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/pages/pages-search_site","routeSlug":"/sai/agent-api/pages/pages-search_site","metadata":{"seo":{"title":"Search for pages on a site","description":"Searches for all pages in a specific site using a search term that matches page titles and content. The response returns the matching pages with their details including the page ID, path, and name."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"pages-search_site","name":"Search for pages on a site","isWebhook":false,"pointer":"/paths/~1api~1v1~1pages~1search/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Search for pages on a site","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Searches for all  pages in a specific site using a search term that matches page titles and content. The response returns the matching pages with their details including the page ID, path, and name."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"search_query","in":"query","schemaId":"schema_1478","description":"The search term to look for in page titles and content.","required":true,"example":"skate"},{"name":"site_name","in":"query","schemaId":"schema_1479","description":"The unique name of the site to search within.","required":true,"example":"skate-park"},{"name":"language","in":"query","schemaId":"schema_1467","description":"The language code for filtering pages.","example":"en"}],"pointer":"/paths/~1api~1v1~1pages~1search/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1pages~1search/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/pages/search","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"search_query","in":"query","required":true,"example":"skate","schemaId":"schema_1478"},{"name":"site_name","in":"query","required":true,"example":"skate-park","schemaId":"schema_1479"},{"name":"language","in":"query","required":false,"example":"en","schemaId":"schema_1467"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/pages/search","href":"pages/pages-search_site","openApiOperationId":"pages-search_site","summary":"Search for pages on a site"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1480"}},"schemaId":"schema_1480"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1pages~1search/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1480","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1480"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/pages/pages-search_site"}],"panels":[]}]},"httpPath":"/api/v1/pages/search"},{"label":"Retrieve the page by live URL","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/pages/pages-get_page_path_by_live_url","routeSlug":"/sai/agent-api/pages/pages-get_page_path_by_live_url","metadata":{"seo":{"title":"Retrieve the page by live URL","description":"Resolves a public live URL to its corresponding page in Sitecore. Use this endpoint when you know the URL of a published page and need to identify the page behind it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"pages-get_page_path_by_live_url","name":"Retrieve the page by live URL","isWebhook":false,"pointer":"/paths/~1api~1v1~1pages~1path-by-url/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve the page by live URL","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Resolves a public live URL to its corresponding page in Sitecore. Use this endpoint when you know the URL of a published page and need to identify the page behind it."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"live_url","in":"query","schemaId":"schema_1481","description":"The full public URL of the page to resolve. The URL must be absolute and include the page path.","required":true,"example":"https://www.sitecore.com/sitecore/content/Verticals/SkatePark/Home"},{"name":"deep","in":"query","schemaId":"schema_1482","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether to search the site's published routes when the standard lookup cannot find the page. Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when a page you know exists is returned as not found, for example when its public URL differs from its item name in Sitecore. This lookup can take significantly longer."},"children":[]}]}]}],"example":false}],"pointer":"/paths/~1api~1v1~1pages~1path-by-url/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1pages~1path-by-url/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/pages/path-by-url","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"live_url","in":"query","required":true,"example":"https://www.sitecore.com/sitecore/content/Verticals/SkatePark/Home","schemaId":"schema_1481"},{"name":"deep","in":"query","required":false,"example":false,"schemaId":"schema_1482"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/pages/path-by-url","href":"pages/pages-get_page_path_by_live_url","openApiOperationId":"pages-get_page_path_by_live_url","summary":"Retrieve the page by live URL"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PagePathByLiveUrlResponse"}},"schemaId":"components/schemas/PagePathByLiveUrlResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1pages~1path-by-url/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/PagePathByLiveUrlResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PagePathByLiveUrlResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/pages/pages-get_page_path_by_live_url"}],"panels":[]}]},"httpPath":"/api/v1/pages/path-by-url"},{"label":"Retrieve the screenshot of a page","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/pages/pages-get_page_screenshot","routeSlug":"/sai/agent-api/pages/pages-get_page_screenshot","metadata":{"seo":{"title":"Retrieve the screenshot of a page","description":"Captures and returns a base64-encoded screenshot of a page."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"pages-get_page_screenshot","name":"Retrieve the screenshot of a page","isWebhook":false,"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1screenshot/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve the screenshot of a page","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Captures and returns a base64-encoded screenshot of a page."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"pageId","in":"path","schemaId":"schema_1471","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"f0b81bcc-7388-46be-b109-6e73d1114470"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1screenshot/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"version","in":"query","schemaId":"schema_1483","description":"The version number of the page to retrieve the screenshot for.","required":true,"example":1},{"name":"language","in":"query","schemaId":"schema_1484","description":"The language code for the page.","example":"en"},{"name":"width","in":"query","schemaId":"schema_1485","description":"The width of the screenshot in pixels.","example":1200},{"name":"height","in":"query","schemaId":"schema_1486","description":"The height of the screenshot in pixels.","example":800},{"name":"variantId","in":"query","schemaId":"schema_1487","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the personalization or A/B/n test variant to show in the screenshot. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint. Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transpiledVariants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"variants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when available."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you provide this value, the screenshot is captured for the specified variant. If you omit this value, the screenshot is captured for the base page."},"children":[]}]}]}],"example":"8bd7a9ec96b8490f9b894e3866fefb79_2a5c1e8c8d244f569a44d6b28cbecb05"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1screenshot/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1screenshot/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/pages/{pageId}/screenshot","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"pageId","in":"path","required":true,"example":"f0b81bcc-7388-46be-b109-6e73d1114470","schemaId":"schema_1471"}],"query":[{"name":"version","in":"query","required":true,"example":1,"schemaId":"schema_1483"},{"name":"language","in":"query","required":false,"example":"en","schemaId":"schema_1484"},{"name":"width","in":"query","required":false,"example":1200,"schemaId":"schema_1485"},{"name":"height","in":"query","required":false,"example":800,"schemaId":"schema_1486"},{"name":"variantId","in":"query","required":false,"example":"8bd7a9ec96b8490f9b894e3866fefb79_2a5c1e8c8d244f569a44d6b28cbecb05","schemaId":"schema_1487"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/pages/{pageId}/screenshot","href":"pages/pages-get_page_screenshot","openApiOperationId":"pages-get_page_screenshot","summary":"Retrieve the screenshot of a page"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PageScreenshotResponse"}},"schemaId":"components/schemas/PageScreenshotResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1screenshot/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/PageScreenshotResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PageScreenshotResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/pages/pages-get_page_screenshot"}],"panels":[]}]},"httpPath":"/api/v1/pages/{pageId}/screenshot"},{"label":"Retrieve the page HTML","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/pages/pages-get_page_html","routeSlug":"/sai/agent-api/pages/pages-get_page_html","metadata":{"seo":{"title":"Retrieve the page HTML","description":"Retrieves the HTML for a specific page. This endpoint returns the raw HTML of the page as it would appear in the browser."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"pages-get_page_html","name":"Retrieve the page HTML","isWebhook":false,"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1html/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve the page HTML","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves the HTML for a specific page. This endpoint returns the raw HTML of the page as it would appear in the browser."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"pageId","in":"path","schemaId":"schema_1488","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"550e8400-e29b-41d4-a716-446655440000"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1html/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"language","in":"query","schemaId":"schema_1489","description":"The language code for the page content.","required":true,"example":"en"},{"name":"version","in":"query","schemaId":"schema_1490","description":"The version number of the page to retrieve.","example":1},{"name":"variantId","in":"query","schemaId":"schema_1491","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the personalization or A/B/n test variant to use. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint. Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transpiledVariants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"variants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when available."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you provide this value, the HTML content is retrieved for the specified variant. If you omit this value, the HTML content for the base page is returned."},"children":[]}]}]}],"example":"8bd7a9ec96b8490f9b894e3866fefb79_2a5c1e8c8d244f569a44d6b28cbecb05"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1html/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1html/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/pages/{pageId}/html","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"pageId","in":"path","required":true,"example":"550e8400-e29b-41d4-a716-446655440000","schemaId":"schema_1488"}],"query":[{"name":"language","in":"query","required":true,"example":"en","schemaId":"schema_1489"},{"name":"version","in":"query","required":false,"example":1,"schemaId":"schema_1490"},{"name":"variantId","in":"query","required":false,"example":"8bd7a9ec96b8490f9b894e3866fefb79_2a5c1e8c8d244f569a44d6b28cbecb05","schemaId":"schema_1491"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/pages/{pageId}/html","href":"pages/pages-get_page_html","openApiOperationId":"pages-get_page_html","summary":"Retrieve the page HTML"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PageHtmlResponse"}},"schemaId":"components/schemas/PageHtmlResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1html/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/PageHtmlResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PageHtmlResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/pages/pages-get_page_html"}],"panels":[]}]},"httpPath":"/api/v1/pages/{pageId}/html"},{"label":"Retrieve the page preview URL","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/pages/pages-get_page_preview_url","routeSlug":"/sai/agent-api/pages/pages-get_page_preview_url","metadata":{"seo":{"title":"Retrieve the page preview URL","description":"Retrieves the preview URL for a specific page."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"pages-get_page_preview_url","name":"Retrieve the page preview URL","isWebhook":false,"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1preview-url/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve the page preview URL","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves the preview URL for a specific page."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"pageId","in":"path","schemaId":"schema_1488","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"550e8400-e29b-41d4-a716-446655440000"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1preview-url/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"language","in":"query","schemaId":"schema_1492","description":"The language code for the page content.","example":"en"},{"name":"version","in":"query","schemaId":"schema_1493","description":"The version number of the page to retrieve the preview URL for.","example":1},{"name":"variantId","in":"query","schemaId":"schema_1494","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the personalization or A/B/n test variant to preview. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint. Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transpiledVariants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"variants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when available."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you provide this value, the preview URL is retrieved for the specified variant. If you omit this value, the preview URL for the base page is returned."},"children":[]}]}]}],"example":"8bd7a9ec96b8490f9b894e3866fefb79_2a5c1e8c8d244f569a44d6b28cbecb05"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1preview-url/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1preview-url/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/pages/{pageId}/preview-url","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"pageId","in":"path","required":true,"example":"550e8400-e29b-41d4-a716-446655440000","schemaId":"schema_1488"}],"query":[{"name":"language","in":"query","required":false,"example":"en","schemaId":"schema_1492"},{"name":"version","in":"query","required":false,"example":1,"schemaId":"schema_1493"},{"name":"variantId","in":"query","required":false,"example":"8bd7a9ec96b8490f9b894e3866fefb79_2a5c1e8c8d244f569a44d6b28cbecb05","schemaId":"schema_1494"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/pages/{pageId}/preview-url","href":"pages/pages-get_page_preview_url","openApiOperationId":"pages-get_page_preview_url","summary":"Retrieve the page preview URL"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetPagePreviewUrlResponse"}},"schemaId":"components/schemas/GetPagePreviewUrlResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1preview-url/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/GetPagePreviewUrlResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetPagePreviewUrlResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/pages/pages-get_page_preview_url"}],"panels":[]}]},"httpPath":"/api/v1/pages/{pageId}/preview-url"},{"label":"Retrieve the page template by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/pages/pages-get_page_template_by_id","routeSlug":"/sai/agent-api/pages/pages-get_page_template_by_id","metadata":{"seo":{"title":"Retrieve the page template by ID","description":"Retrieves the details of a specific page template, including its fields and settings. Use this endpoint to understand the structure and available fields of a template before creating a page."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"pages-get_page_template_by_id","name":"Retrieve the page template by ID","isWebhook":false,"pointer":"/paths/~1api~1v1~1pages~1template-by-id/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve the page template by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves the details of a specific page template, including its fields and settings. Use this endpoint to understand the structure and available fields of a template before creating a page."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"templateId","in":"query","schemaId":"schema_1495","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page template. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_templates_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List templates of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint."},"children":[]}]}]}],"required":true,"example":"2341ef32-42f4-4537-98d8-9ef741008eab"}],"pointer":"/paths/~1api~1v1~1pages~1template-by-id/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1pages~1template-by-id/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/pages/template-by-id","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"templateId","in":"query","required":true,"example":"2341ef32-42f4-4537-98d8-9ef741008eab","schemaId":"schema_1495"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/pages/template-by-id","href":"pages/pages-get_page_template_by_id","openApiOperationId":"pages-get_page_template_by_id","summary":"Retrieve the page template by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PageTemplateResponse"}},"schemaId":"components/schemas/PageTemplateResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1pages~1template-by-id/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/PageTemplateResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PageTemplateResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/pages/pages-get_page_template_by_id"}],"panels":[]}]},"httpPath":"/api/v1/pages/template-by-id"},{"label":"Retrieve the page details","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/pages/pages-get_page","routeSlug":"/sai/agent-api/pages/pages-get_page","metadata":{"seo":{"title":"Retrieve the page details","description":"Retrieves the details about a page including its ID, name, and path location. This endpoint provides the information you need to understand and modify the page's structure."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"pages-get_page","name":"Retrieve the page details","isWebhook":false,"pointer":"/paths/~1api~1v1~1pages~1{pageId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve the page details","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves the details about a page including its ID, name, and path location. This endpoint provides the information you need to understand and modify the page's structure."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"pageId","in":"path","schemaId":"schema_1488","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"550e8400-e29b-41d4-a716-446655440000"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"language","in":"query","schemaId":"schema_1492","description":"The language code for the page content.","example":"en"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/pages/{pageId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"pageId","in":"path","required":true,"example":"550e8400-e29b-41d4-a716-446655440000","schemaId":"schema_1488"}],"query":[{"name":"language","in":"query","required":false,"example":"en","schemaId":"schema_1492"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/pages/{pageId}","href":"pages/pages-get_page","openApiOperationId":"pages-get_page","summary":"Retrieve the page details"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetPageResponse"}},"schemaId":"components/schemas/GetPageResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/GetPageResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetPageResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/pages/pages-get_page"}],"panels":[]}]},"httpPath":"/api/v1/pages/{pageId}"},{"label":"List allowed components for a placeholder","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/pages/pages-get_allowed_components_by_placeholder","routeSlug":"/sai/agent-api/pages/pages-get_allowed_components_by_placeholder","metadata":{"seo":{"title":"List allowed components for a placeholder","description":"Retrieves the list of components that can be added to a placeholder on a page. This helps ensure that only compatible components are used in each placeholder."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"pages-get_allowed_components_by_placeholder","name":"List allowed components for a placeholder","isWebhook":false,"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1placeholders~1{placeholderName}~1allowed-components/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List allowed components for a placeholder","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves the list of components that can be added to a placeholder on a page. This helps ensure that only compatible components are used in each placeholder."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"pageId","in":"path","schemaId":"schema_1488","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"550e8400-e29b-41d4-a716-446655440000"},{"name":"placeholderName","in":"path","schemaId":"schema_1496","description":"The unique identifier of the placeholder.","required":true,"example":"123e4567-e89b-12d3-a456-426614174000"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1placeholders~1{placeholderName}~1allowed-components/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"language","in":"query","schemaId":"schema_1473","description":"The language code for filtering components.","example":"en"},{"name":"variantId","in":"query","schemaId":"schema_1497","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the personalization or A/B/n test variant to use. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint. Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transpiledVariants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"variants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when available."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you provide this value, the list of allowed components is retrieved for the specified variant. If you omit this value, the list for the base page is returned."},"children":[]}]}]}],"example":"8bd7a9ec96b8490f9b894e3866fefb79_2a5c1e8c8d244f569a44d6b28cbecb05"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1placeholders~1{placeholderName}~1allowed-components/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1placeholders~1{placeholderName}~1allowed-components/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/pages/{pageId}/placeholders/{placeholderName}/allowed-components","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"pageId","in":"path","required":true,"example":"550e8400-e29b-41d4-a716-446655440000","schemaId":"schema_1488"},{"name":"placeholderName","in":"path","required":true,"example":"123e4567-e89b-12d3-a456-426614174000","schemaId":"schema_1496"}],"query":[{"name":"language","in":"query","required":false,"example":"en","schemaId":"schema_1473"},{"name":"variantId","in":"query","required":false,"example":"8bd7a9ec96b8490f9b894e3866fefb79_2a5c1e8c8d244f569a44d6b28cbecb05","schemaId":"schema_1497"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/pages/{pageId}/placeholders/{placeholderName}/allowed-components","href":"pages/pages-get_allowed_components_by_placeholder","openApiOperationId":"pages-get_allowed_components_by_placeholder","summary":"List allowed components for a placeholder"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1498"}},"schemaId":"schema_1498"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1pages~1{pageId}~1placeholders~1{placeholderName}~1allowed-components/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1498","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1498"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/pages/pages-get_allowed_components_by_placeholder"}],"panels":[]}]},"httpPath":"/api/v1/pages/{pageId}/placeholders/{placeholderName}/allowed-components"}],"content":{"contentType":"group","meta":{"name":"Pages"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Pages","showPageActions":true},{"nodeType":"markdoc","content":"The Pages API lets you create new pages, add new language versions or components to a page, search for pages on a site, set the component datasource on a page, retrieve page components, paths, HTML, preview URL, screenshots, templates, details, and allowed components."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v1/pages/create","summary":"Create a page","prefix":{"name":"post","color":"post"},"badges":[],"link":"/pages/pages-create_page","deprecated":false},{"title":"/api/v1/pages/{pageId}/add-language","summary":"Add a language version to a page","prefix":{"name":"post","color":"post"},"badges":[],"link":"/pages/pages-add_language_to_page","deprecated":false},{"title":"/api/v1/pages/{pageId}/components","summary":"Add a component to a page","prefix":{"name":"post","color":"post"},"badges":[],"link":"/pages/pages-add_component_on_page","deprecated":false},{"title":"/api/v1/pages/{pageId}/components","summary":"Retrieve components on a page","prefix":{"name":"get","color":"get"},"badges":[],"link":"/pages/pages-get_components_on_page","deprecated":false},{"title":"/api/v1/pages/{pageId}/components/{componentId}/datasource","summary":"Set the component datasource","prefix":{"name":"post","color":"post"},"badges":[],"link":"/pages/pages-set_component_datasource","deprecated":false},{"title":"/api/v1/pages/search","summary":"Search for pages on a site","prefix":{"name":"get","color":"get"},"badges":[],"link":"/pages/pages-search_site","deprecated":false},{"title":"/api/v1/pages/path-by-url","summary":"Retrieve the page by live URL","prefix":{"name":"get","color":"get"},"badges":[],"link":"/pages/pages-get_page_path_by_live_url","deprecated":false},{"title":"/api/v1/pages/{pageId}/screenshot","summary":"Retrieve the screenshot of a page","prefix":{"name":"get","color":"get"},"badges":[],"link":"/pages/pages-get_page_screenshot","deprecated":false},{"title":"/api/v1/pages/{pageId}/html","summary":"Retrieve the page HTML","prefix":{"name":"get","color":"get"},"badges":[],"link":"/pages/pages-get_page_html","deprecated":false},{"title":"/api/v1/pages/{pageId}/preview-url","summary":"Retrieve the page preview URL","prefix":{"name":"get","color":"get"},"badges":[],"link":"/pages/pages-get_page_preview_url","deprecated":false},{"title":"/api/v1/pages/template-by-id","summary":"Retrieve the page template by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/pages/pages-get_page_template_by_id","deprecated":false},{"title":"/api/v1/pages/{pageId}","summary":"Retrieve the page details","prefix":{"name":"get","color":"get"},"badges":[],"link":"/pages/pages-get_page","deprecated":false},{"title":"/api/v1/pages/{pageId}/placeholders/{placeholderName}/allowed-components","summary":"List allowed components for a placeholder","prefix":{"name":"get","color":"get"},"badges":[],"link":"/pages/pages-get_allowed_components_by_placeholder","deprecated":false}]}]}]}]}},{"type":"group","label":"Content","link":"/sai/agent-api/content","routeSlug":"/sai/agent-api/content","items":[{"label":"Create content item","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/content/content-create_content_item","routeSlug":"/sai/agent-api/content/content-create_content_item","metadata":{"seo":{"title":"Create content item","description":"Creates a new content item using the specified template and field values."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"content-create_content_item","name":"Create content item","isWebhook":false,"pointer":"/paths/~1api~1v1~1content~1create/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create content item","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates a new content item using the specified template and field values."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1content~1create/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateContentItemRequest"}},"schemaId":"components/schemas/CreateContentItemRequest","pointer":"/paths/~1api~1v1~1content~1create/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/content/create","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateContentItemRequest"}},"responseCodes":["201","422"],"pointer":"/api/v1/content/create","href":"content/content-create_content_item","openApiOperationId":"content-create_content_item","summary":"Create content item"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/CreateContentItemRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateContentItemRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreateContentItemResponse"}},"schemaId":"components/schemas/CreateContentItemResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1content~1create/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/CreateContentItemResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreateContentItemResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/content/content-create_content_item"}],"panels":[]}]},"httpPath":"/api/v1/content/create"},{"label":"Retrieve a content item by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/content/content-get_content_item_by_id","routeSlug":"/sai/agent-api/content/content-get_content_item_by_id","metadata":{"seo":{"title":"Retrieve a content item by ID","description":"Retrieves the details of a specific content item by specifying its ID."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"content-get_content_item_by_id","name":"Retrieve a content item by ID","isWebhook":false,"pointer":"/paths/~1api~1v1~1content~1{itemId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a content item by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves the details of a specific content item by specifying its ID."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"itemId","in":"path","schemaId":"schema_1499","description":"The unique identifier of the content item to be retrieved.","required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"}],"pointer":"/paths/~1api~1v1~1content~1{itemId}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"language","in":"query","schemaId":"schema_1500","description":"The language version of the content item to be retrieved. If not specified, the default language is used.","example":"en"}],"pointer":"/paths/~1api~1v1~1content~1{itemId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1content~1{itemId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/content/{itemId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"itemId","in":"path","required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301","schemaId":"schema_1499"}],"query":[{"name":"language","in":"query","required":false,"example":"en","schemaId":"schema_1500"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/content/{itemId}","href":"content/content-get_content_item_by_id","openApiOperationId":"content-get_content_item_by_id","summary":"Retrieve a content item by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContentItemResponse"}},"schemaId":"components/schemas/ContentItemResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1content~1{itemId}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ContentItemResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContentItemResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/content/content-get_content_item_by_id"}],"panels":[]}]},"httpPath":"/api/v1/content/{itemId}"},{"label":"Update a content item","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/content/content-update_content","routeSlug":"/sai/agent-api/content/content-update_content","metadata":{"seo":{"title":"Update a content item","description":"Updates an existing content item, including its fields and language."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"content-update_content","name":"Update a content item","isWebhook":false,"pointer":"/paths/~1api~1v1~1content~1{itemId}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a content item","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Updates an existing content item, including its fields and language."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"itemId","in":"path","schemaId":"schema_1501","description":"The unique identifier of the content item to be updated.","required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"}],"pointer":"/paths/~1api~1v1~1content~1{itemId}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1content~1{itemId}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateContentRequest"}},"schemaId":"components/schemas/UpdateContentRequest","pointer":"/paths/~1api~1v1~1content~1{itemId}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v1/content/{itemId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"itemId","in":"path","required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301","schemaId":"schema_1501"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateContentRequest"}},"responseCodes":["200","422"],"pointer":"/api/v1/content/{itemId}","href":"content/content-update_content","openApiOperationId":"content-update_content","summary":"Update a content item"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/UpdateContentRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateContentRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UpdateContentResponse"}},"schemaId":"components/schemas/UpdateContentResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1content~1{itemId}/put/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/UpdateContentResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UpdateContentResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/content/content-update_content"}],"panels":[]}]},"httpPath":"/api/v1/content/{itemId}"},{"label":"Delete a content item","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/content/content-delete_content","routeSlug":"/sai/agent-api/content/content-delete_content","metadata":{"seo":{"title":"Delete a content item","description":"Deletes a content item and optionally all of its child items."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"content-delete_content","name":"Delete a content item","isWebhook":false,"pointer":"/paths/~1api~1v1~1content~1{itemId}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a content item","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Deletes a content item and optionally all of its child items."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"itemId","in":"path","schemaId":"schema_1502","description":"The unique identifier of the content item to be deleted.","required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"}],"pointer":"/paths/~1api~1v1~1content~1{itemId}/delete/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"language","in":"query","schemaId":"schema_1503","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language version of the content item."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Deleting a content item removes the item across all language versions. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"language"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter does not limit deletion to a specific language version."},"children":[]}]}]}],"example":"en"}],"pointer":"/paths/~1api~1v1~1content~1{itemId}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1content~1{itemId}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v1/content/{itemId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"itemId","in":"path","required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301","schemaId":"schema_1502"}],"query":[{"name":"language","in":"query","required":false,"example":"en","schemaId":"schema_1503"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/content/{itemId}","href":"content/content-delete_content","openApiOperationId":"content-delete_content","summary":"Delete a content item"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/DeleteContentResponse"}},"schemaId":"components/schemas/DeleteContentResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1content~1{itemId}/delete/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/DeleteContentResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/DeleteContentResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/content/content-delete_content"}],"panels":[]}]},"httpPath":"/api/v1/content/{itemId}"},{"label":"Retrieve a content item by path","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/content/content-get_content_item_by_path","routeSlug":"/sai/agent-api/content/content-get_content_item_by_path","metadata":{"seo":{"title":"Retrieve a content item by path","description":"Retrieves the details of a content item by specifying its path in the content tree."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"content-get_content_item_by_path","name":"Retrieve a content item by path","isWebhook":false,"pointer":"/paths/~1api~1v1~1content/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a content item by path","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves the details of a content item by specifying its path in the content tree."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"item_path","in":"query","schemaId":"schema_1504","description":"The path of the content item in the content tree.","required":true,"example":"%2Fsitecore%2Fcontent%2FVerticals%2FSkaterPark%2FHome"},{"name":"failOnNotFound","in":"query","schemaId":"schema_1505","description":"Determines the behavior when the content item is not found.","example":"true"},{"name":"language","in":"query","schemaId":"schema_1506","description":"The language version of the content item to be retrieved.","example":"en"}],"pointer":"/paths/~1api~1v1~1content/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1content/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/content","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"item_path","in":"query","required":true,"example":"%2Fsitecore%2Fcontent%2FVerticals%2FSkaterPark%2FHome","schemaId":"schema_1504"},{"name":"failOnNotFound","in":"query","required":false,"example":"true","schemaId":"schema_1505"},{"name":"language","in":"query","required":false,"example":"en","schemaId":"schema_1506"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/content","href":"content/content-get_content_item_by_path","openApiOperationId":"content-get_content_item_by_path","summary":"Retrieve a content item by path"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1507"}},"schemaId":"schema_1507"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1content/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1507","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1507"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/content/content-get_content_item_by_path"}],"panels":[]}]},"httpPath":"/api/v1/content"},{"label":"List insert options","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/content/content-list_available_insertoptions","routeSlug":"/sai/agent-api/content/content-list_available_insertoptions","metadata":{"seo":{"title":"List insert options","description":"Retrieves a list of content templates that can be inserted as child items under the specified parent item."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"content-list_available_insertoptions","name":"List insert options","isWebhook":false,"pointer":"/paths/~1api~1v1~1content~1{itemId}~1insert-options/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List insert options","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 content templates that can be inserted as child items under the specified parent item."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"itemId","in":"path","schemaId":"schema_1508","description":"The unique identifier of the parent item under which new items can be inserted.","required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"}],"pointer":"/paths/~1api~1v1~1content~1{itemId}~1insert-options/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"language","in":"query","schemaId":"schema_1509","description":"The language code for filtering insert options.","example":"en"}],"pointer":"/paths/~1api~1v1~1content~1{itemId}~1insert-options/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1content~1{itemId}~1insert-options/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/content/{itemId}/insert-options","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"itemId","in":"path","required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301","schemaId":"schema_1508"}],"query":[{"name":"language","in":"query","required":false,"example":"en","schemaId":"schema_1509"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/content/{itemId}/insert-options","href":"content/content-list_available_insertoptions","openApiOperationId":"content-list_available_insertoptions","summary":"List insert options"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1510"}},"schemaId":"schema_1510"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1content~1{itemId}~1insert-options/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1510","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1510"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/content/content-list_available_insertoptions"}],"panels":[]}]},"httpPath":"/api/v1/content/{itemId}/insert-options"}],"content":{"contentType":"group","meta":{"name":"Content"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Content","showPageActions":true},{"nodeType":"markdoc","content":"The Content API lets you create, retrieve, update, delete and organize structured content items, and retrieve insert options."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v1/content/create","summary":"Create content item","prefix":{"name":"post","color":"post"},"badges":[],"link":"/content/content-create_content_item","deprecated":false},{"title":"/api/v1/content/{itemId}","summary":"Retrieve a content item by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/content/content-get_content_item_by_id","deprecated":false},{"title":"/api/v1/content/{itemId}","summary":"Update a content item","prefix":{"name":"put","color":"put"},"badges":[],"link":"/content/content-update_content","deprecated":false},{"title":"/api/v1/content/{itemId}","summary":"Delete a content item","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/content/content-delete_content","deprecated":false},{"title":"/api/v1/content","summary":"Retrieve a content item by path","prefix":{"name":"get","color":"get"},"badges":[],"link":"/content/content-get_content_item_by_path","deprecated":false},{"title":"/api/v1/content/{itemId}/insert-options","summary":"List insert options","prefix":{"name":"get","color":"get"},"badges":[],"link":"/content/content-list_available_insertoptions","deprecated":false}]}]}]}]}},{"type":"group","label":"Components","link":"/sai/agent-api/components","routeSlug":"/sai/agent-api/components","items":[{"label":"Create a component datasource","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/components/components-create_component_datasource","routeSlug":"/sai/agent-api/components/components-create_component_datasource","metadata":{"seo":{"title":"Create a component datasource","description":"Creates a new datasource item for a specific component using the provided data field values. The datasource will be created in the appropriate location based on the component's configuration."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"components-create_component_datasource","name":"Create a component datasource","isWebhook":false,"pointer":"/paths/~1api~1v1~1components~1{componentId}~1datasources/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a component datasource","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates a new datasource item for a specific component using the provided data field values. The datasource will be created in the appropriate location based on the component's configuration."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"componentId","in":"path","schemaId":"schema_1511","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the component for which to create a datasource. To get this ID, use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/pages-get_allowed_components_by_placeholder"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List allowed components for a placeholder"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint."},"children":[]}]}]}],"required":true,"example":"86a03271-dff4-470a-92bd-b68c67de2e25"}],"pointer":"/paths/~1api~1v1~1components~1{componentId}~1datasources/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1components~1{componentId}~1datasources/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateComponentDatasourceRequest"}},"schemaId":"components/schemas/CreateComponentDatasourceRequest","pointer":"/paths/~1api~1v1~1components~1{componentId}~1datasources/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/components/{componentId}/datasources","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"componentId","in":"path","required":true,"example":"86a03271-dff4-470a-92bd-b68c67de2e25","schemaId":"schema_1511"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateComponentDatasourceRequest"}},"responseCodes":["201","422"],"pointer":"/api/v1/components/{componentId}/datasources","href":"components/components-create_component_datasource","openApiOperationId":"components-create_component_datasource","summary":"Create a component datasource"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/CreateComponentDatasourceRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateComponentDatasourceRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreateComponentDatasourceResponse"}},"schemaId":"components/schemas/CreateComponentDatasourceResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1components~1{componentId}~1datasources/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/CreateComponentDatasourceResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreateComponentDatasourceResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/components-create_component_datasource"}],"panels":[]}]},"httpPath":"/api/v1/components/{componentId}/datasources"},{"label":"Search for component datasources","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/components/components-search_component_datasources","routeSlug":"/sai/agent-api/components/components-search_component_datasources","metadata":{"seo":{"title":"Search for component datasources","description":"Searches for available datasources that can be used with a specific component. This helps you find existing content to use as datasources."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"components-search_component_datasources","name":"Search for component datasources","isWebhook":false,"pointer":"/paths/~1api~1v1~1components~1{componentId}~1datasources~1search/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Search for component datasources","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Searches for available datasources that can be used with a specific component. This helps you find existing content to use as datasources."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"componentId","in":"path","schemaId":"schema_1512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the component for which to search datasources. To get this ID, use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/pages-get_allowed_components_by_placeholder"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List allowed components for a placeholder"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint."},"children":[]}]}]}],"required":true,"example":"86a03271-dff4-470a-92bd-b68c67de2e25"}],"pointer":"/paths/~1api~1v1~1components~1{componentId}~1datasources~1search/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"term","in":"query","schemaId":"schema_1513","description":"The search term to filter available datasources.","required":true,"example":"news"}],"pointer":"/paths/~1api~1v1~1components~1{componentId}~1datasources~1search/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1components~1{componentId}~1datasources~1search/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/components/{componentId}/datasources/search","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"componentId","in":"path","required":true,"example":"86a03271-dff4-470a-92bd-b68c67de2e25","schemaId":"schema_1512"}],"query":[{"name":"term","in":"query","required":true,"example":"news","schemaId":"schema_1513"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/components/{componentId}/datasources/search","href":"components/components-search_component_datasources","openApiOperationId":"components-search_component_datasources","summary":"Search for component datasources"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SearchResponse"}},"schemaId":"components/schemas/SearchResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1components~1{componentId}~1datasources~1search/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/SearchResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SearchResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/components-search_component_datasources"}],"panels":[]}]},"httpPath":"/api/v1/components/{componentId}/datasources/search"},{"label":"List components","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/components/components-list_components","routeSlug":"/sai/agent-api/components/components-list_components","metadata":{"seo":{"title":"List components","description":"Retrieves a list of components available for a specific site, including both built-in components and custom components that can be used on pages."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"components-list_components","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 available for a specific site, including both built-in components and custom components that can be used on pages."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"site_name","in":"query","schemaId":"schema_1514","description":"The name of the site for which to list available components.","required":true,"example":"skate-park"}],"pointer":"/paths/~1api~1v1~1components/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"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/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"site_name","in":"query","required":true,"example":"skate-park","schemaId":"schema_1514"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/components","href":"components/components-list_components","openApiOperationId":"components-list_components","summary":"List components"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ComponentsResponse"}},"schemaId":"components/schemas/ComponentsResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1components/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ComponentsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ComponentsResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/components-list_components"}],"panels":[]}]},"httpPath":"/api/v1/components"},{"label":"Retrieve the component details","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/components/components-get_component","routeSlug":"/sai/agent-api/components/components-get_component","metadata":{"seo":{"title":"Retrieve the component details","description":"Retrieves the details of a specific component, including its ID, name, and datasource options."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"components-get_component","name":"Retrieve the component details","isWebhook":false,"pointer":"/paths/~1api~1v1~1components~1{componentId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve the component details","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves the details of a specific component, including its ID, name, and datasource options."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"componentId","in":"path","schemaId":"schema_1515","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the component. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/pages-get_all_components_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List components of a page"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"86a03271-dff4-470a-92bd-b68c67de2e25"}],"pointer":"/paths/~1api~1v1~1components~1{componentId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"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/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"componentId","in":"path","required":true,"example":"86a03271-dff4-470a-92bd-b68c67de2e25","schemaId":"schema_1515"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/components/{componentId}","href":"components/components-get_component","openApiOperationId":"components-get_component","summary":"Retrieve the component details"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ComponentResponse"}},"schemaId":"components/schemas/ComponentResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1components~1{componentId}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ComponentResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ComponentResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/components/components-get_component"}],"panels":[]}]},"httpPath":"/api/v1/components/{componentId}"}],"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 retrieve components, get the details of a specific component, search datasources in a component, and create a component datasource."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v1/components/{componentId}/datasources","summary":"Create a component datasource","prefix":{"name":"post","color":"post"},"badges":[],"link":"/components/components-create_component_datasource","deprecated":false},{"title":"/api/v1/components/{componentId}/datasources/search","summary":"Search for component datasources","prefix":{"name":"get","color":"get"},"badges":[],"link":"/components/components-search_component_datasources","deprecated":false},{"title":"/api/v1/components","summary":"List components","prefix":{"name":"get","color":"get"},"badges":[],"link":"/components/components-list_components","deprecated":false},{"title":"/api/v1/components/{componentId}","summary":"Retrieve the component details","prefix":{"name":"get","color":"get"},"badges":[],"link":"/components/components-get_component","deprecated":false}]}]}]}]}},{"type":"group","label":"Assets","link":"/sai/agent-api/assets","routeSlug":"/sai/agent-api/assets","items":[{"label":"Upload an asset","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/assets/assets-upload_asset","routeSlug":"/sai/agent-api/assets/assets-upload_asset","metadata":{"seo":{"title":"Upload an asset","description":"Uploads a new digital asset to the system and stores it with the provided metadata."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"assets-upload_asset","name":"Upload an asset","isWebhook":false,"pointer":"/paths/~1api~1v1~1assets~1upload/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Upload an asset","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Uploads a new digital asset to the system and stores it with the provided metadata."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1assets~1upload/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["multipart/form-data"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"components/schemas/Body_assets-upload_asset"}},"schemaId":"components/schemas/Body_assets-upload_asset","pointer":"/paths/~1api~1v1~1assets~1upload/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/assets/upload","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"multipart/form-data":{"schemaId":"components/schemas/Body_assets-upload_asset"}},"responseCodes":["201","422"],"pointer":"/api/v1/assets/upload","href":"assets/assets-upload_asset","openApiOperationId":"assets-upload_asset","summary":"Upload an asset"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/Body_assets-upload_asset","mediaTypes":["multipart/form-data"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"components/schemas/Body_assets-upload_asset"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UploadAssetResponse"}},"schemaId":"components/schemas/UploadAssetResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1assets~1upload/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/UploadAssetResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UploadAssetResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/assets/assets-upload_asset"}],"panels":[]}]},"httpPath":"/api/v1/assets/upload"},{"label":"Search for assets","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/assets/assets-search_assets","routeSlug":"/sai/agent-api/assets/assets-search_assets","metadata":{"seo":{"title":"Search for assets","description":"Searches for digital assets such as videos, images, and documents using query terms, file types, or tags."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"assets-search_assets","name":"Search for assets","isWebhook":false,"pointer":"/paths/~1api~1v1~1assets~1search/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Search for assets","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":"Searches for digital assets such as videos, images, and documents using query terms, file types, or tags."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Limitations"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Asset search results are limited to a maximum of 10 items per request."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint doesn't support pagination. Parameters such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pageNumber"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pageSize"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"continuationToken"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are ignored."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response does not include pagination metadata such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"totalCount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"query","in":"query","schemaId":"schema_1516","description":"The search term to filter assets.","example":"summer"},{"name":"language","in":"query","schemaId":"schema_1517","description":"The language code to filter assets.","example":"en"},{"name":"type","in":"query","schemaId":"schema_1518","description":"The file type to filter assets such as image, video, or document.","example":"image"}],"pointer":"/paths/~1api~1v1~1assets~1search/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1assets~1search/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/assets/search","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"query","in":"query","required":false,"example":"summer","schemaId":"schema_1516"},{"name":"language","in":"query","required":false,"example":"en","schemaId":"schema_1517"},{"name":"type","in":"query","required":false,"example":"image","schemaId":"schema_1518"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/assets/search","href":"assets/assets-search_assets","openApiOperationId":"assets-search_assets","summary":"Search for assets"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1519"}},"schemaId":"schema_1519"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1assets~1search/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1519","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1519"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/assets/assets-search_assets"}],"panels":[]}]},"httpPath":"/api/v1/assets/search"},{"label":"Retrieve the asset details","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/assets/assets-get_asset_information","routeSlug":"/sai/agent-api/assets/assets-get_asset_information","metadata":{"seo":{"title":"Retrieve the asset details","description":"Retrieves the details of a specific digital asset by specifying its ID."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"assets-get_asset_information","name":"Retrieve the asset details","isWebhook":false,"pointer":"/paths/~1api~1v1~1assets~1{assetId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve the asset details","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves the details of a specific digital asset by specifying its ID."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"assetId","in":"path","schemaId":"schema_1520","description":"The unique identifier of the asset to be retrieved.","required":true,"example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890"}],"pointer":"/paths/~1api~1v1~1assets~1{assetId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1assets~1{assetId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/assets/{assetId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"assetId","in":"path","required":true,"example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","schemaId":"schema_1520"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/assets/{assetId}","href":"assets/assets-get_asset_information","openApiOperationId":"assets-get_asset_information","summary":"Retrieve the asset details"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AssetInformationResponse"}},"schemaId":"components/schemas/AssetInformationResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1assets~1{assetId}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/AssetInformationResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AssetInformationResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/assets/assets-get_asset_information"}],"panels":[]}]},"httpPath":"/api/v1/assets/{assetId}"},{"label":"Update an asset","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/assets/assets-update_asset","routeSlug":"/sai/agent-api/assets/assets-update_asset","metadata":{"seo":{"title":"Update an asset","description":"Updates the metadata and properties of an existing digital asset, such as alt text, description, and tags."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"assets-update_asset","name":"Update an asset","isWebhook":false,"pointer":"/paths/~1api~1v1~1assets~1{assetId}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update an asset","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Updates the metadata and properties of an existing digital asset, such as alt text, description, and tags."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"assetId","in":"path","schemaId":"schema_1521","description":"The unique identifier of the asset to be updated.","required":true,"example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890"}],"pointer":"/paths/~1api~1v1~1assets~1{assetId}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1assets~1{assetId}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateAssetRequest"}},"schemaId":"components/schemas/UpdateAssetRequest","pointer":"/paths/~1api~1v1~1assets~1{assetId}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v1/assets/{assetId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"assetId","in":"path","required":true,"example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","schemaId":"schema_1521"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateAssetRequest"}},"responseCodes":["200","422"],"pointer":"/api/v1/assets/{assetId}","href":"assets/assets-update_asset","openApiOperationId":"assets-update_asset","summary":"Update an asset"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/UpdateAssetRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateAssetRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UpdateAssetResponse"}},"schemaId":"components/schemas/UpdateAssetResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1assets~1{assetId}/put/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/UpdateAssetResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UpdateAssetResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/assets/assets-update_asset"}],"panels":[]}]},"httpPath":"/api/v1/assets/{assetId}"}],"content":{"contentType":"group","meta":{"name":"Assets"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Assets","showPageActions":true},{"nodeType":"markdoc","content":"The Assets API lets you upload, search assets, retrieve asset details, and update asset metadata."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v1/assets/upload","summary":"Upload an asset","prefix":{"name":"post","color":"post"},"badges":[],"link":"/assets/assets-upload_asset","deprecated":false},{"title":"/api/v1/assets/search","summary":"Search for assets","prefix":{"name":"get","color":"get"},"badges":[],"link":"/assets/assets-search_assets","deprecated":false},{"title":"/api/v1/assets/{assetId}","summary":"Retrieve the asset details","prefix":{"name":"get","color":"get"},"badges":[],"link":"/assets/assets-get_asset_information","deprecated":false},{"title":"/api/v1/assets/{assetId}","summary":"Update an asset","prefix":{"name":"put","color":"put"},"badges":[],"link":"/assets/assets-update_asset","deprecated":false}]}]}]}]}},{"type":"group","label":"Environments","link":"/sai/agent-api/environments","routeSlug":"/sai/agent-api/environments","items":[{"label":"List languages","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/environments/environments-list_languages","routeSlug":"/sai/agent-api/environments/environments-list_languages","metadata":{"seo":{"title":"List languages","description":"Retrieves all languages available."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"environments-list_languages","name":"List languages","isWebhook":false,"pointer":"/paths/~1api~1v1~1environments~1languages/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List languages","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves all languages available."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1522","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API. ","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1environments~1languages/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/environments/languages","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1522"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/environments/languages","href":"environments/environments-list_languages","openApiOperationId":"environments-list_languages","summary":"List languages"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1523"}},"schemaId":"schema_1523"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1environments~1languages/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1523","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1523"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/environments/environments-list_languages"}],"panels":[]}]},"httpPath":"/api/v1/environments/languages"}],"content":{"contentType":"group","meta":{"name":"Environments"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Environments","showPageActions":true},{"nodeType":"markdoc","content":"The Environments API lets you retrieve available languages in your environment."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v1/environments/languages","summary":"List languages","prefix":{"name":"get","color":"get"},"badges":[],"link":"/environments/environments-list_languages","deprecated":false}]}]}]}]}},{"type":"group","label":"Personalization","link":"/sai/agent-api/personalization","routeSlug":"/sai/agent-api/personalization","items":[{"label":"Create a personalization variant","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/personalization/personalization-create_personalization_version","routeSlug":"/sai/agent-api/personalization/personalization-create_personalization_version","metadata":{"seo":{"title":"Create a personalization variant","description":"Creates a new personalization variant of a page, enabling you to define targeting rules for different audiences."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"personalization-create_personalization_version","name":"Create a personalization variant","isWebhook":false,"pointer":"/paths/~1api~1v2~1personalization~1{pageId}~1versions/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a personalization variant","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates a new personalization variant of a page, enabling you to define targeting rules for different audiences."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"pageId","in":"path","schemaId":"schema_1524","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page for which to create a personalization version. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"}],"pointer":"/paths/~1api~1v2~1personalization~1{pageId}~1versions/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v2~1personalization~1{pageId}~1versions/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreatePersonalizationRequestV2"}},"schemaId":"components/schemas/CreatePersonalizationRequestV2","pointer":"/paths/~1api~1v2~1personalization~1{pageId}~1versions/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v2/personalization/{pageId}/versions","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"pageId","in":"path","required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301","schemaId":"schema_1524"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreatePersonalizationRequestV2"}},"responseCodes":["201","422"],"pointer":"/api/v2/personalization/{pageId}/versions","href":"personalization/personalization-create_personalization_version","openApiOperationId":"personalization-create_personalization_version","summary":"Create a personalization variant"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/CreatePersonalizationRequestV2","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreatePersonalizationRequestV2"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExperienceFlowResponseV2"}},"schemaId":"components/schemas/ExperienceFlowResponseV2"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v2~1personalization~1{pageId}~1versions/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/ExperienceFlowResponseV2","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExperienceFlowResponseV2"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/personalization/personalization-create_personalization_version"}],"panels":[]}]},"httpPath":"/api/v2/personalization/{pageId}/versions"},{"label":"List personalization variants by page","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/personalization/personalization-get_personalization_versions_by_page","routeSlug":"/sai/agent-api/personalization/personalization-get_personalization_versions_by_page","metadata":{"seo":{"title":"List personalization variants by page","description":"Retrieves all personalization variants defined for a specific page, including IDs, names, creation dates, and associated variants."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"personalization-get_personalization_versions_by_page","name":"List personalization variants by page","isWebhook":false,"pointer":"/paths/~1api~1v2~1personalization~1by-page~1{pageId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List personalization variants by page","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves all personalization variants defined for a specific page, including IDs, names, creation dates, and associated variants."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"pageId","in":"path","schemaId":"schema_1525","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page for which to retrieve personalization versions. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"}],"pointer":"/paths/~1api~1v2~1personalization~1by-page~1{pageId}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"language","in":"query","schemaId":"schema_1526","description":"The language version of the page.","example":"en"}],"pointer":"/paths/~1api~1v2~1personalization~1by-page~1{pageId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v2~1personalization~1by-page~1{pageId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v2/personalization/by-page/{pageId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"pageId","in":"path","required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301","schemaId":"schema_1525"}],"query":[{"name":"language","in":"query","required":false,"example":"en","schemaId":"schema_1526"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v2/personalization/by-page/{pageId}","href":"personalization/personalization-get_personalization_versions_by_page","openApiOperationId":"personalization-get_personalization_versions_by_page","summary":"List personalization variants by page"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1527"}},"schemaId":"schema_1527"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v2~1personalization~1by-page~1{pageId}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1527","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1527"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/personalization/personalization-get_personalization_versions_by_page"}],"panels":[]}]},"httpPath":"/api/v2/personalization/by-page/{pageId}"},{"label":"List personalization condition templates","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/personalization/personalization-get_condition_templates","routeSlug":"/sai/agent-api/personalization/personalization-get_condition_templates","metadata":{"seo":{"title":"List personalization condition templates","description":"Retrieves all available condition templates for personalization."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"personalization-get_condition_templates","name":"List personalization condition templates","isWebhook":false,"pointer":"/paths/~1api~1v1~1personalization~1condition-templates/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List personalization condition templates","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves all available condition templates for personalization."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1personalization~1condition-templates/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/personalization/condition-templates","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/personalization/condition-templates","href":"personalization/personalization-get_condition_templates","openApiOperationId":"personalization-get_condition_templates","summary":"List personalization condition templates"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1528"}},"schemaId":"schema_1528"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1personalization~1condition-templates/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1528","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1528"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/personalization/personalization-get_condition_templates"}],"panels":[]}]},"httpPath":"/api/v1/personalization/condition-templates"},{"label":"Retrieve a personalization condition template","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/personalization/personalization-get_condition_template_by_id","routeSlug":"/sai/agent-api/personalization/personalization-get_condition_template_by_id","metadata":{"seo":{"title":"Retrieve a personalization condition template","description":"Retrieves a condition template by ID including its parameters for creating a personalization variant on a page."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"personalization-get_condition_template_by_id","name":"Retrieve a personalization condition template","isWebhook":false,"pointer":"/paths/~1api~1v1~1personalization~1condition-templates~1{template_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a personalization condition template","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves a condition template by ID including its parameters for creating a personalization variant on a page."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"template_id","in":"path","schemaId":"schema_1529","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the condition template. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/operation/personalization-get_condition_templates"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List personalization condition templates"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of available condition templates."},"children":[]}]}]}],"required":true,"example":"returning_visitor"}],"pointer":"/paths/~1api~1v1~1personalization~1condition-templates~1{template_id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1personalization~1condition-templates~1{template_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/personalization/condition-templates/{template_id}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"template_id","in":"path","required":true,"example":"returning_visitor","schemaId":"schema_1529"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/personalization/condition-templates/{template_id}","href":"personalization/personalization-get_condition_template_by_id","openApiOperationId":"personalization-get_condition_template_by_id","summary":"Retrieve a personalization condition template"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ConditionTemplate"}},"schemaId":"components/schemas/ConditionTemplate"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1personalization~1condition-templates~1{template_id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ConditionTemplate","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ConditionTemplate"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/personalization/personalization-get_condition_template_by_id"}],"panels":[]}]},"httpPath":"/api/v1/personalization/condition-templates/{template_id}"},{"label":"Update a personalization variant for a page","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/personalization/personalization-update_personalization_version","routeSlug":"/sai/agent-api/personalization/personalization-update_personalization_version","metadata":{"seo":{"title":"Update a personalization variant for a page","description":"Updates the audience name, variant name, and targeting rules of an existing personalization variant."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"personalization-update_personalization_version","name":"Update a personalization variant for a page","isWebhook":false,"pointer":"/paths/~1api~1v1~1personalization~1{pageId}~1versions~1{variantId}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a personalization variant for a page","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Updates the audience name, variant name, and targeting rules of an existing personalization variant."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"pageId","in":"path","schemaId":"schema_1530","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page for which to update a personalization variant. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of pages for a specific site."},"children":[]}]}]}],"required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},{"name":"variantId","in":"path","schemaId":"schema_1531","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the personalization variant to be updated. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/operation/personalization-get_personalization_versions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List personalization variants by page"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint. Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transpiledVariants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"variants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when available."},"children":[]}]}]}],"required":true,"example":"afbdf7912c774dd997f5c7c9d627708e_7ccdaf587ae54fe4919996192507c383"}],"pointer":"/paths/~1api~1v1~1personalization~1{pageId}~1versions~1{variantId}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1personalization~1{pageId}~1versions~1{variantId}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdatePersonalizationRequest"}},"schemaId":"components/schemas/UpdatePersonalizationRequest","pointer":"/paths/~1api~1v1~1personalization~1{pageId}~1versions~1{variantId}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v1/personalization/{pageId}/versions/{variantId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"pageId","in":"path","required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301","schemaId":"schema_1530"},{"name":"variantId","in":"path","required":true,"example":"afbdf7912c774dd997f5c7c9d627708e_7ccdaf587ae54fe4919996192507c383","schemaId":"schema_1531"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdatePersonalizationRequest"}},"responseCodes":["200","422"],"pointer":"/api/v1/personalization/{pageId}/versions/{variantId}","href":"personalization/personalization-update_personalization_version","openApiOperationId":"personalization-update_personalization_version","summary":"Update a personalization variant for a page"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/UpdatePersonalizationRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdatePersonalizationRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExperienceFlowResponseV2"}},"schemaId":"components/schemas/ExperienceFlowResponseV2"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1personalization~1{pageId}~1versions~1{variantId}/put/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ExperienceFlowResponseV2","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExperienceFlowResponseV2"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/personalization/personalization-update_personalization_version"}],"panels":[]}]},"httpPath":"/api/v1/personalization/{pageId}/versions/{variantId}"},{"label":"Hide a component on the default page variant","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/personalization/personalization-hide_component_on_default_page","routeSlug":"/sai/agent-api/personalization/personalization-hide_component_on_default_page","metadata":{"seo":{"title":"Hide a component on the default page variant","description":"Hides a component on the default page variant. Personalization must already exist on the page before you use this endpoint. A default page variant exists only after page variants have been created to personalize a page."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"personalization-hide_component_on_default_page","name":"Hide a component on the default page variant","isWebhook":false,"pointer":"/paths/~1api~1v1~1personalization~1{pageId}~1components~1{componentId}~1hide/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Hide a component on the default page variant","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Hides a component on the default page variant. Personalization must already exist on the page before you use this endpoint. A default page variant exists only after page variants have been created to personalize a page. "},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"pageId","in":"path","schemaId":"schema_1532","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page that includes the default page variant where the component should be hidden. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of pages for a specific site."},"children":[]}]}]}],"required":true},{"name":"componentId","in":"path","schemaId":"schema_1533","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the component to hide on the default page variant. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/pages-get_all_components_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List components of a page"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of components for a specific page."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1api~1v1~1personalization~1{pageId}~1components~1{componentId}~1hide/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1534","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API."}],"pointer":"/paths/~1api~1v1~1personalization~1{pageId}~1components~1{componentId}~1hide/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/HideComponentRequest"}},"schemaId":"components/schemas/HideComponentRequest","pointer":"/paths/~1api~1v1~1personalization~1{pageId}~1components~1{componentId}~1hide/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/personalization/{pageId}/components/{componentId}/hide","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"pageId","in":"path","required":true,"schemaId":"schema_1532"},{"name":"componentId","in":"path","required":true,"schemaId":"schema_1533"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"schemaId":"schema_1534"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/HideComponentRequest"}},"responseCodes":["201","422"],"pointer":"/api/v1/personalization/{pageId}/components/{componentId}/hide","href":"personalization/personalization-hide_component_on_default_page","openApiOperationId":"personalization-hide_component_on_default_page","summary":"Hide a component on the default page variant"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/HideComponentRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/HideComponentRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HideComponentResponse"}},"schemaId":"components/schemas/HideComponentResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1personalization~1{pageId}~1components~1{componentId}~1hide/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/HideComponentResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HideComponentResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/personalization/personalization-hide_component_on_default_page"}],"panels":[]}]},"httpPath":"/api/v1/personalization/{pageId}/components/{componentId}/hide"},{"label":"Create a personalization variant","deprecated":true,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/personalization/personalization-create_personalization_version_v1","routeSlug":"/sai/agent-api/personalization/personalization-create_personalization_version_v1","metadata":{"seo":{"title":"Create a personalization variant","description":"Creates a new personalization variant of a page using a single condition template and parameters."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"personalization-create_personalization_version_v1","name":"Create a personalization variant","deprecated":true,"isWebhook":false,"pointer":"/paths/~1api~1v1~1personalization~1{pageId}~1versions/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a personalization variant","isWebhook":false,"deprecated":true,"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":"Creates a new personalization variant of a page using a single condition template and parameters."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This endpoint is maintained for backward compatibility and will be deprecated and removed on August 4, 2026. Use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://api-docs.sitecore.com/sai/agent-api/personalization/personalization-create_personalization_version"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a personalization variant v2 endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" going forward."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"pageId","in":"path","schemaId":"schema_1535","required":true}],"pointer":"/paths/~1api~1v1~1personalization~1{pageId}~1versions/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1personalization~1{pageId}~1versions/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreatePersonalizationRequestV1"}},"schemaId":"components/schemas/CreatePersonalizationRequestV1","pointer":"/paths/~1api~1v1~1personalization~1{pageId}~1versions/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/personalization/{pageId}/versions","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"pageId","in":"path","required":true,"schemaId":"schema_1535"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreatePersonalizationRequestV1"}},"responseCodes":["201","422"],"pointer":"/api/v1/personalization/{pageId}/versions","href":"personalization/personalization-create_personalization_version_v1","openApiOperationId":"personalization-create_personalization_version_v1","summary":"Create a personalization variant"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/CreatePersonalizationRequestV1","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreatePersonalizationRequestV1"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExperienceFlowResponseV1"}},"schemaId":"components/schemas/ExperienceFlowResponseV1"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1personalization~1{pageId}~1versions/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/ExperienceFlowResponseV1","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExperienceFlowResponseV1"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/personalization/personalization-create_personalization_version_v1"}],"panels":[]}]},"httpPath":"/api/v1/personalization/{pageId}/versions"},{"label":"List personalization variants by page","deprecated":true,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/personalization/personalization-get_personalization_versions_by_page_v1","routeSlug":"/sai/agent-api/personalization/personalization-get_personalization_versions_by_page_v1","metadata":{"seo":{"title":"List personalization variants by page","description":"Retrieves all personalization versions configured for a specific page, including their targeting rules and content variations."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"personalization-get_personalization_versions_by_page_v1","name":"List personalization variants by page","deprecated":true,"isWebhook":false,"pointer":"/paths/~1api~1v1~1personalization~1by-page~1{pageId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List personalization variants by page","isWebhook":false,"deprecated":true,"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 all personalization versions configured for a specific page, including their targeting rules and content variations."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This endpoint is maintained for backward compatibility and will be deprecated and removed on August 4, 2026. Use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://api-docs.sitecore.com/sai/agent-api/personalization/personalization-get_personalization_versions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List personalization variants by page v2 endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" going forward."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"pageId","in":"path","schemaId":"schema_1535","required":true}],"pointer":"/paths/~1api~1v1~1personalization~1by-page~1{pageId}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"language","in":"query","schemaId":"schema_1536"}],"pointer":"/paths/~1api~1v1~1personalization~1by-page~1{pageId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1personalization~1by-page~1{pageId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/personalization/by-page/{pageId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"pageId","in":"path","required":true,"schemaId":"schema_1535"}],"query":[{"name":"language","in":"query","required":false,"schemaId":"schema_1536"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/personalization/by-page/{pageId}","href":"personalization/personalization-get_personalization_versions_by_page_v1","openApiOperationId":"personalization-get_personalization_versions_by_page_v1","summary":"List personalization variants by page"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1537"}},"schemaId":"schema_1537"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1personalization~1by-page~1{pageId}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1537","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1537"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/personalization/personalization-get_personalization_versions_by_page_v1"}],"panels":[]}]},"httpPath":"/api/v1/personalization/by-page/{pageId}"}],"content":{"contentType":"group","meta":{"name":"Personalization"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Personalization","showPageActions":true},{"nodeType":"markdoc","content":"The Personalization API lets you create personalized variants for different audiences by showing targeted content based on certain conditions."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v2/personalization/{pageId}/versions","summary":"Create a personalization variant","prefix":{"name":"post","color":"post"},"badges":[],"link":"/personalization/personalization-create_personalization_version","deprecated":false},{"title":"/api/v2/personalization/by-page/{pageId}","summary":"List personalization variants by page","prefix":{"name":"get","color":"get"},"badges":[],"link":"/personalization/personalization-get_personalization_versions_by_page","deprecated":false},{"title":"/api/v1/personalization/condition-templates","summary":"List personalization condition templates","prefix":{"name":"get","color":"get"},"badges":[],"link":"/personalization/personalization-get_condition_templates","deprecated":false},{"title":"/api/v1/personalization/condition-templates/{template_id}","summary":"Retrieve a personalization condition template","prefix":{"name":"get","color":"get"},"badges":[],"link":"/personalization/personalization-get_condition_template_by_id","deprecated":false},{"title":"/api/v1/personalization/{pageId}/versions/{variantId}","summary":"Update a personalization variant for a page","prefix":{"name":"put","color":"put"},"badges":[],"link":"/personalization/personalization-update_personalization_version","deprecated":false},{"title":"/api/v1/personalization/{pageId}/components/{componentId}/hide","summary":"Hide a component on the default page variant","prefix":{"name":"post","color":"post"},"badges":[],"link":"/personalization/personalization-hide_component_on_default_page","deprecated":false},{"title":"/api/v1/personalization/{pageId}/versions","summary":"Create a personalization variant","prefix":{"name":"post","color":"http-deprecated"},"badges":[],"link":"/personalization/personalization-create_personalization_version_v1","deprecated":true},{"title":"/api/v1/personalization/by-page/{pageId}","summary":"List personalization variants by page","prefix":{"name":"get","color":"http-deprecated"},"badges":[],"link":"/personalization/personalization-get_personalization_versions_by_page_v1","deprecated":true}]}]}]}]}},{"type":"group","label":"Jobs","link":"/sai/agent-api/jobs","routeSlug":"/sai/agent-api/jobs","items":[{"label":"Revert a job","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/jobs/jobs-revert_job","routeSlug":"/sai/agent-api/jobs/jobs-revert_job","metadata":{"seo":{"title":"Revert a job","description":"Reverts the operations linked to a specific job ID, restoring the state prior to execution. This is useful for undoing changes made by automated processes."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"jobs-revert_job","name":"Revert a job","isWebhook":false,"pointer":"/paths/~1api~1v1~1jobs~1{jobId}~1revert/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Revert a job","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Reverts the operations linked to a specific job ID, restoring the state prior to execution. This is useful for undoing changes made by automated processes."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"jobId","in":"path","schemaId":"schema_1538","description":"The unique identifier of the job to be reverted.","required":true,"example":"job-1234"}],"pointer":"/paths/~1api~1v1~1jobs~1{jobId}~1revert/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/jobs/{jobId}/revert","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"jobId","in":"path","required":true,"example":"job-1234","schemaId":"schema_1538"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["201","422"],"pointer":"/api/v1/jobs/{jobId}/revert","href":"jobs/jobs-revert_job","openApiOperationId":"jobs-revert_job","summary":"Revert a job"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1539"}},"schemaId":"schema_1539"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1jobs~1{jobId}~1revert/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"schema_1539","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1539"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/jobs/jobs-revert_job"}],"panels":[]}]},"httpPath":"/api/v1/jobs/{jobId}/revert"},{"label":"Retrieve job details","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/jobs/jobs-get_job","routeSlug":"/sai/agent-api/jobs/jobs-get_job","metadata":{"seo":{"title":"Retrieve job details","description":"Retrieves the details of a specific job."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"jobs-get_job","name":"Retrieve job details","isWebhook":false,"pointer":"/paths/~1api~1v1~1jobs~1{jobId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve job details","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves the details of a specific job."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"jobId","in":"path","schemaId":"schema_1540","description":"The unique identifier of the job to retrieve.","required":true,"example":"job-1234"}],"pointer":"/paths/~1api~1v1~1jobs~1{jobId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/jobs/{jobId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"jobId","in":"path","required":true,"example":"job-1234","schemaId":"schema_1540"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/jobs/{jobId}","href":"jobs/jobs-get_job","openApiOperationId":"jobs-get_job","summary":"Retrieve job details"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1541"}},"schemaId":"schema_1541"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1jobs~1{jobId}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1541","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1541"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/jobs/jobs-get_job"}],"panels":[]}]},"httpPath":"/api/v1/jobs/{jobId}"},{"label":"List job operations","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/jobs/jobs-list_operations","routeSlug":"/sai/agent-api/jobs/jobs-list_operations","metadata":{"seo":{"title":"List job operations","description":"Retrieves a list of actions associated with a specific job ID, including operation type, status, and timestamps, to support tracing and potential reversion of those actions."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"jobs-list_operations","name":"List job operations","isWebhook":false,"pointer":"/paths/~1api~1v1~1jobs~1{jobId}~1operations/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List job operations","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 actions associated with a specific job ID, including operation type, status, and timestamps, to support tracing and potential reversion of those actions."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"jobId","in":"path","schemaId":"schema_1542","description":"The unique identifier of the job for which to list operations.","required":true,"example":"job-1234"}],"pointer":"/paths/~1api~1v1~1jobs~1{jobId}~1operations/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/jobs/{jobId}/operations","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"jobId","in":"path","required":true,"example":"job-1234","schemaId":"schema_1542"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/jobs/{jobId}/operations","href":"jobs/jobs-list_operations","openApiOperationId":"jobs-list_operations","summary":"List job operations"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1543"}},"schemaId":"schema_1543"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1jobs~1{jobId}~1operations/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1543","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1543"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/jobs/jobs-list_operations"}],"panels":[]}]},"httpPath":"/api/v1/jobs/{jobId}/operations"}],"content":{"contentType":"group","meta":{"name":"Jobs"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Jobs","showPageActions":true},{"nodeType":"markdoc","content":"The Jobs API lets you retrieve all details and operations of a specific job or revert a job to undo changes made during an operation."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v1/jobs/{jobId}/revert","summary":"Revert a job","prefix":{"name":"post","color":"post"},"badges":[],"link":"/jobs/jobs-revert_job","deprecated":false},{"title":"/api/v1/jobs/{jobId}","summary":"Retrieve job details","prefix":{"name":"get","color":"get"},"badges":[],"link":"/jobs/jobs-get_job","deprecated":false},{"title":"/api/v1/jobs/{jobId}/operations","summary":"List job operations","prefix":{"name":"get","color":"get"},"badges":[],"link":"/jobs/jobs-list_operations","deprecated":false}]}]}]}]}},{"type":"group","label":"Brand kits","link":"/sai/agent-api/brand-kits","routeSlug":"/sai/agent-api/brand-kits","items":[{"label":"List brand kits","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/brand-kits/brandkits-list_brandkits","routeSlug":"/sai/agent-api/brand-kits/brandkits-list_brandkits","metadata":{"seo":{"title":"List brand kits","description":"Retrieves all brand kits available within an organization."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"brandkits-list_brandkits","name":"List brand kits","isWebhook":false,"pointer":"/paths/~1api~1v1~1brandkits/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List brand kits","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves all brand kits available within an organization."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1brandkits/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/brandkits","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/brandkits","href":"brand-kits/brandkits-list_brandkits","openApiOperationId":"brandkits-list_brandkits","summary":"List brand kits"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1544"}},"schemaId":"schema_1544"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1brandkits/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1544","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1544"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/brand-kits/brandkits-list_brandkits"}],"panels":[]}]},"httpPath":"/api/v1/brandkits"},{"label":"Retrieve a brand kit by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/brand-kits/brandkits-get_brandkit_by_id","routeSlug":"/sai/agent-api/brand-kits/brandkits-get_brandkit_by_id","metadata":{"seo":{"title":"Retrieve a brand kit by ID","description":"Retrieves a brand kit by ID, including its sections and associated fields (subsections)."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"brandkits-get_brandkit_by_id","name":"Retrieve a brand kit by ID","isWebhook":false,"pointer":"/paths/~1api~1v1~1brandkits~1{brandkitId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a brand kit by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves a brand kit by ID, including its sections and associated fields (subsections)."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"brandkitId","in":"path","schemaId":"schema_1545","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the brand kit to retrieve. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/brandkits-list_brandkits"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List brand kits"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of brand kits in your organization."},"children":[]}]}]}],"required":true,"example":"f2657200-e881-4027-8ddf-a9810eb9d177"}],"pointer":"/paths/~1api~1v1~1brandkits~1{brandkitId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1brandkits~1{brandkitId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/brandkits/{brandkitId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"brandkitId","in":"path","required":true,"example":"f2657200-e881-4027-8ddf-a9810eb9d177","schemaId":"schema_1545"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/brandkits/{brandkitId}","href":"brand-kits/brandkits-get_brandkit_by_id","openApiOperationId":"brandkits-get_brandkit_by_id","summary":"Retrieve a brand kit by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetBrandKitResponse"}},"schemaId":"components/schemas/GetBrandKitResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1brandkits~1{brandkitId}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/GetBrandKitResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetBrandKitResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/brand-kits/brandkits-get_brandkit_by_id"}],"panels":[]}]},"httpPath":"/api/v1/brandkits/{brandkitId}"}],"content":{"contentType":"group","meta":{"name":"Brand kits"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Brand kits","showPageActions":true},{"nodeType":"markdoc","content":"The Brand kits API lets you retrieve a list of brand kits and details of a specific brandkit."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v1/brandkits","summary":"List brand kits","prefix":{"name":"get","color":"get"},"badges":[],"link":"/brand-kits/brandkits-list_brandkits","deprecated":false},{"title":"/api/v1/brandkits/{brandkitId}","summary":"Retrieve a brand kit by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/brand-kits/brandkits-get_brandkit_by_id","deprecated":false}]}]}]}]}},{"type":"group","label":"Brand contexts","link":"/sai/agent-api/brand-contexts","routeSlug":"/sai/agent-api/brand-contexts","items":[{"label":"List brand contexts","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/brand-contexts/brand-contexts-list_brand_contexts","routeSlug":"/sai/agent-api/brand-contexts/brand-contexts-list_brand_contexts","metadata":{"seo":{"title":"List brand contexts","description":"Retrieves all brand contexts available within an organization. Returns metadata only; document content is not included."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"brand-contexts-list_brand_contexts","name":"List brand contexts","isWebhook":false,"pointer":"/paths/~1api~1v1~1brand-contexts/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List brand contexts","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves all brand contexts available within an organization. Returns metadata only; document content is not included."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1brand-contexts/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/brand-contexts","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/brand-contexts","href":"brand-contexts/brand-contexts-list_brand_contexts","openApiOperationId":"brand-contexts-list_brand_contexts","summary":"List brand contexts"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1546"}},"schemaId":"schema_1546"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1brand-contexts/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1546","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1546"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/brand-contexts/brand-contexts-list_brand_contexts"}],"panels":[]}]},"httpPath":"/api/v1/brand-contexts"},{"label":"Retrieve a brand context by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/brand-contexts/brand-contexts-get_brand_context","routeSlug":"/sai/agent-api/brand-contexts/brand-contexts-get_brand_context","metadata":{"seo":{"title":"Retrieve a brand context by ID","description":"Retrieves a brand context's metadata and its complete nested folder or file tree index. No document content is included."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"brand-contexts-get_brand_context","name":"Retrieve a brand context by ID","isWebhook":false,"pointer":"/paths/~1api~1v1~1brand-contexts~1{brandContextId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a brand context by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves a brand context's metadata and its complete nested folder or file tree index. No document content is included."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"brandContextId","in":"path","schemaId":"schema_1547","required":true}],"pointer":"/paths/~1api~1v1~1brand-contexts~1{brandContextId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1brand-contexts~1{brandContextId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/brand-contexts/{brandContextId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"brandContextId","in":"path","required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301","schemaId":"schema_1547"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/brand-contexts/{brandContextId}","href":"brand-contexts/brand-contexts-get_brand_context","openApiOperationId":"brand-contexts-get_brand_context","summary":"Retrieve a brand context by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetBrandContextResponse"}},"schemaId":"components/schemas/GetBrandContextResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1brand-contexts~1{brandContextId}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/GetBrandContextResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetBrandContextResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/brand-contexts/brand-contexts-get_brand_context"}],"panels":[]}]},"httpPath":"/api/v1/brand-contexts/{brandContextId}"},{"label":"Batch retrieve brand context items","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/brand-contexts/brand-contexts-get_brand_context_items","routeSlug":"/sai/agent-api/brand-contexts/brand-contexts-get_brand_context_items","metadata":{"seo":{"title":"Batch retrieve brand context items","description":"Retrieves specific files or folders from a brand context in a single batched call. File responses include Markdown content. Between 1 and 50 unique IDs per call. A single failed item is returned with fetchStatus is failed and the upstream error message in fetchStatusMessage rather than failing the whole batch. The response carries requested, succeeded, or failed completeness counts alongside the data array."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"brand-contexts-get_brand_context_items","name":"Batch retrieve brand context items","isWebhook":false,"pointer":"/paths/~1api~1v1~1brand-contexts~1{brandContextId}~1items/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Batch retrieve brand context items","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieves specific files or folders from a brand context in a single batched call. File responses include Markdown content. Between 1 and 50 unique IDs per call. A single failed item is returned with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fetchStatus"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the upstream error message in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fetchStatusMessage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rather than failing the whole batch. The response carries requested, succeeded, or failed completeness counts alongside the data array."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"brandContextId","in":"path","schemaId":"schema_1548","required":true}],"pointer":"/paths/~1api~1v1~1brand-contexts~1{brandContextId}~1items/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"ids","in":"query","schemaId":"schema_1549","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comma-separated brand context item IDs (UUIDs) of files or folders to fetch, up to 50. To get these IDs, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/brand-contexts-get_brand_context"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieve a brand context by ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the complete nested folder or file tree index of the brand context."},"children":[]}]}]}],"required":true,"example":["3f2504e0-4f89-11d3-9a0c-0305e82c3301,a1b2c3d4-4f89-11d3-9a0c-0305e82c3301"]}],"pointer":"/paths/~1api~1v1~1brand-contexts~1{brandContextId}~1items/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1brand-contexts~1{brandContextId}~1items/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/brand-contexts/{brandContextId}/items","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"brandContextId","in":"path","required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301","schemaId":"schema_1548"}],"query":[{"name":"ids","in":"query","required":true,"example":["3f2504e0-4f89-11d3-9a0c-0305e82c3301,a1b2c3d4-4f89-11d3-9a0c-0305e82c3301"],"schemaId":"schema_1549"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/brand-contexts/{brandContextId}/items","href":"brand-contexts/brand-contexts-get_brand_context_items","openApiOperationId":"brand-contexts-get_brand_context_items","summary":"Batch retrieve brand context items"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BrandContextBatchGetResponse"}},"schemaId":"components/schemas/BrandContextBatchGetResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1brand-contexts~1{brandContextId}~1items/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/BrandContextBatchGetResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BrandContextBatchGetResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/brand-contexts/brand-contexts-get_brand_context_items"}],"panels":[]}]},"httpPath":"/api/v1/brand-contexts/{brandContextId}/items"}],"content":{"contentType":"group","meta":{"name":"Brand contexts"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Brand contexts","showPageActions":true},{"nodeType":"markdoc","content":"The Brand contexts API lets you retrieve brand contexts, their metadata, nested folder and file trees, and document content."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v1/brand-contexts","summary":"List brand contexts","prefix":{"name":"get","color":"get"},"badges":[],"link":"/brand-contexts/brand-contexts-list_brand_contexts","deprecated":false},{"title":"/api/v1/brand-contexts/{brandContextId}","summary":"Retrieve a brand context by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/brand-contexts/brand-contexts-get_brand_context","deprecated":false},{"title":"/api/v1/brand-contexts/{brandContextId}/items","summary":"Batch retrieve brand context items","prefix":{"name":"get","color":"get"},"badges":[],"link":"/brand-contexts/brand-contexts-get_brand_context_items","deprecated":false}]}]}]}]}},{"type":"group","label":"Briefs","link":"/sai/agent-api/briefs","routeSlug":"/sai/agent-api/briefs","items":[{"label":"List brief types","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/briefs/list-brief_types","routeSlug":"/sai/agent-api/briefs/list-brief_types","metadata":{"seo":{"title":"List brief types","description":"Retrieves a list of available brief types, including their metadata and field definitions such as field types, labels, validation rules, and other information used by AI when generating briefs."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"list-brief_types","name":"List brief types","isWebhook":false,"pointer":"/paths/~1api~1v1~1brief~1brief-types/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List brief types","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 available brief types, including their metadata and field definitions such as field types, labels, validation rules, and other information used by AI when generating briefs."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1brief~1brief-types/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/brief/brief-types","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/brief/brief-types","href":"briefs/list-brief_types","openApiOperationId":"list-brief_types","summary":"List brief types"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListBriefTypesResponse"}},"schemaId":"components/schemas/ListBriefTypesResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1brief~1brief-types/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ListBriefTypesResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListBriefTypesResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/briefs/list-brief_types"}],"panels":[]}]},"httpPath":"/api/v1/brief/brief-types"},{"label":"List briefs","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/briefs/list-briefs","routeSlug":"/sai/agent-api/briefs/list-briefs","metadata":{"seo":{"title":"List briefs","description":"Retrieves a list of briefs in your organization."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"list-briefs","name":"List briefs","isWebhook":false,"pointer":"/paths/~1api~1v1~1brief/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List briefs","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 briefs in your organization."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"name","in":"query","schemaId":"schema_1550","description":"The name of the brief to filter the list of briefs by. Supports partial matches, for example, if you specify 'summer', it will match briefs with names like 'Summer Campaign Brief' or '2026 Summer Product Launch Brief'.","example":"summer"},{"name":"status","in":"query","schemaId":"schema_1551","description":"The status of the brief, such as draft, active, or archived.","example":"active"},{"name":"creator_id","in":"query","schemaId":"schema_1552","description":"The unique identifier of the user who created the brief.","example":"user-1234"},{"name":"type_id","in":"query","schemaId":"schema_1553","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the brief type to filter briefs by. To get the list of brief type IDs, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/list-brief_types"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List brief types"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint."},"children":[]}]}]}],"example":"brieftype-1234"},{"name":"sort_by","in":"query","schemaId":"schema_1554","description":"The field by which to sort the list of briefs.","example":"name"}],"pointer":"/paths/~1api~1v1~1brief/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1brief/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/brief","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"name","in":"query","required":false,"example":"summer","schemaId":"schema_1550"},{"name":"status","in":"query","required":false,"example":"active","schemaId":"schema_1551"},{"name":"creator_id","in":"query","required":false,"example":"user-1234","schemaId":"schema_1552"},{"name":"type_id","in":"query","required":false,"example":"brieftype-1234","schemaId":"schema_1553"},{"name":"sort_by","in":"query","required":false,"example":"name","schemaId":"schema_1554"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/brief","href":"briefs/list-briefs","openApiOperationId":"list-briefs","summary":"List briefs"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListBriefsResponse"}},"schemaId":"components/schemas/ListBriefsResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1brief/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ListBriefsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListBriefsResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/briefs/list-briefs"}],"panels":[]}]},"httpPath":"/api/v1/brief"},{"label":"Create a brief","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/briefs/brief-create_brief","routeSlug":"/sai/agent-api/briefs/brief-create_brief","metadata":{"seo":{"title":"Create a brief","description":"Creates a brief using the specified brief type ID, locale, and provided data fields. The new brief is saved as a draft in the Brief management tool."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"brief-create_brief","name":"Create a brief","isWebhook":false,"pointer":"/paths/~1api~1v1~1brief/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a brief","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":"Creates a brief using the specified brief type ID, locale, and provided data fields. The new brief is saved as a draft in the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/sai/en/users/sitecoreai/managing-briefs.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Brief management tool"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1brief/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateBriefRequestModel"}},"schemaId":"components/schemas/CreateBriefRequestModel","pointer":"/paths/~1api~1v1~1brief/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/brief","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateBriefRequestModel"}},"responseCodes":["201","422"],"pointer":"/api/v1/brief","href":"briefs/brief-create_brief","openApiOperationId":"brief-create_brief","summary":"Create a brief"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/CreateBriefRequestModel","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateBriefRequestModel"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreateBriefResponseModel"}},"schemaId":"components/schemas/CreateBriefResponseModel"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1brief/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/CreateBriefResponseModel","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreateBriefResponseModel"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/briefs/brief-create_brief"}],"panels":[]}]},"httpPath":"/api/v1/brief"},{"label":"Generate a brief","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/briefs/briefs-generate_brief","routeSlug":"/sai/agent-api/briefs/briefs-generate_brief","metadata":{"seo":{"title":"Generate a brief","description":"Generates a brief draft and the content of its fields, using the specified brief type, brand kit, and prompt. This endpoint does not save the generated draft. You can copy the response and use the Create a brief endpoint to save it in the Brief management tool."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"briefs-generate_brief","name":"Generate a brief","isWebhook":false,"pointer":"/paths/~1api~1v1~1brief~1generate/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Generate a brief","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":"Generates a brief draft and the content of its fields, using the specified brief type, brand kit, and prompt. This endpoint does not save the generated draft. You can copy the response and use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/brief-create_brief"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a brief"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to save it in the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/sai/en/users/sitecoreai/managing-briefs.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Brief management tool"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1brief~1generate/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/GenerateBriefRequest"}},"schemaId":"components/schemas/GenerateBriefRequest","pointer":"/paths/~1api~1v1~1brief~1generate/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/brief/generate","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/GenerateBriefRequest"}},"responseCodes":["200","422"],"pointer":"/api/v1/brief/generate","href":"briefs/briefs-generate_brief","openApiOperationId":"briefs-generate_brief","summary":"Generate a brief"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/GenerateBriefRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/GenerateBriefRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GenerateBriefResponse"}},"schemaId":"components/schemas/GenerateBriefResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1brief~1generate/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/GenerateBriefResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GenerateBriefResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/briefs/briefs-generate_brief"}],"panels":[]}]},"httpPath":"/api/v1/brief/generate"},{"label":"Retrieve a brief type by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/briefs/get-brief_type_by_id","routeSlug":"/sai/agent-api/briefs/get-brief_type_by_id","metadata":{"seo":{"title":"Retrieve a brief type by ID","description":"Retrieves a specific brief type by its ID, including its field definitions and metadata."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-brief_type_by_id","name":"Retrieve a brief type by ID","isWebhook":false,"pointer":"/paths/~1api~1v1~1brief~1brief-types~1{brief_type_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a brief type by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves a specific brief type by its ID, including its field definitions and metadata."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"brief_type_id","in":"path","schemaId":"schema_1555","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the brief type to retrieve. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/list-brief_types"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List brief types"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of brief types available in your organization."},"children":[]}]}]}],"required":true,"example":"bt-1234"}],"pointer":"/paths/~1api~1v1~1brief~1brief-types~1{brief_type_id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1brief~1brief-types~1{brief_type_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/brief/brief-types/{brief_type_id}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"brief_type_id","in":"path","required":true,"example":"bt-1234","schemaId":"schema_1555"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/brief/brief-types/{brief_type_id}","href":"briefs/get-brief_type_by_id","openApiOperationId":"get-brief_type_by_id","summary":"Retrieve a brief type by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetBriefTypeResponse"}},"schemaId":"components/schemas/GetBriefTypeResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1brief~1brief-types~1{brief_type_id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/GetBriefTypeResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetBriefTypeResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/briefs/get-brief_type_by_id"}],"panels":[]}]},"httpPath":"/api/v1/brief/brief-types/{brief_type_id}"},{"label":"Retrieve a brief by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/briefs/get-brief_by_id","routeSlug":"/sai/agent-api/briefs/get-brief_by_id","metadata":{"seo":{"title":"Retrieve a brief by ID","description":"Retrieves a specific brief by its ID, including its fields, type reference, and metadata."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-brief_by_id","name":"Retrieve a brief by ID","isWebhook":false,"pointer":"/paths/~1api~1v1~1brief~1{brief_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a brief by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves a specific brief by its ID, including its fields, type reference, and metadata."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"brief_id","in":"path","schemaId":"schema_1556","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the brief to retrieve. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/list-briefs"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List briefs"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of briefs in your organization."},"children":[]}]}]}],"required":true,"example":"brief-1234"}],"pointer":"/paths/~1api~1v1~1brief~1{brief_id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1brief~1{brief_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/brief/{brief_id}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"brief_id","in":"path","required":true,"example":"brief-1234","schemaId":"schema_1556"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/brief/{brief_id}","href":"briefs/get-brief_by_id","openApiOperationId":"get-brief_by_id","summary":"Retrieve a brief by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetBriefResponse"}},"schemaId":"components/schemas/GetBriefResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1brief~1{brief_id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/GetBriefResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetBriefResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/briefs/get-brief_by_id"}],"panels":[]}]},"httpPath":"/api/v1/brief/{brief_id}"},{"label":"Update a brief","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/briefs/brief-update_brief","routeSlug":"/sai/agent-api/briefs/brief-update_brief","metadata":{"seo":{"title":"Update a brief","description":"Partially updates an existing brief using the provided fields. Only the fields included in the request body will be updated; all other existing fields will remain unchanged."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"brief-update_brief","name":"Update a brief","isWebhook":false,"pointer":"/paths/~1api~1v1~1brief~1{brief_id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a brief","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Partially updates an existing brief using the provided fields. Only the fields included in the request body will be updated; all other existing fields will remain unchanged."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"brief_id","in":"path","schemaId":"schema_1556","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the brief to retrieve. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/list-briefs"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List briefs"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of briefs in your organization."},"children":[]}]}]}],"required":true,"example":"brief-1234"}],"pointer":"/paths/~1api~1v1~1brief~1{brief_id}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1brief~1{brief_id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateBriefRequestModel"}},"schemaId":"components/schemas/UpdateBriefRequestModel","pointer":"/paths/~1api~1v1~1brief~1{brief_id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v1/brief/{brief_id}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"brief_id","in":"path","required":true,"example":"brief-1234","schemaId":"schema_1556"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateBriefRequestModel"}},"responseCodes":["200","422"],"pointer":"/api/v1/brief/{brief_id}","href":"briefs/brief-update_brief","openApiOperationId":"brief-update_brief","summary":"Update a brief"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/UpdateBriefRequestModel","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateBriefRequestModel"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UpdateBriefResponse"}},"schemaId":"components/schemas/UpdateBriefResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1brief~1{brief_id}/put/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/UpdateBriefResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UpdateBriefResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/briefs/brief-update_brief"}],"panels":[]}]},"httpPath":"/api/v1/brief/{brief_id}"},{"label":"Generate a brief","deprecated":true,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/briefs/briefs-generate_brief_deprecated","routeSlug":"/sai/agent-api/briefs/briefs-generate_brief_deprecated","metadata":{"seo":{"title":"Generate a brief","description":"Generates a brief and the content of its fields, using the specified brief type, brand kit, and prompt. This endpoint does not save the generated draft. You can copy the response and use the Create a brief endpoint to save it in the Brief management tool."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"briefs-generate_brief_deprecated","name":"Generate a brief","deprecated":true,"isWebhook":false,"pointer":"/paths/~1api~1v1~1briefs~1generate/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Generate a brief","isWebhook":false,"deprecated":true,"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":"Generates a brief and the content of its fields, using the specified brief type, brand kit, and prompt. This endpoint does not save the generated draft. You can copy the response and use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/brief-create_brief"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a brief"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to save it in the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/sai/en/users/sitecoreai/managing-briefs.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Brief management tool"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This endpoint is maintained for backward compatibility and will be deprecated and removed on September 20, 2026. Use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://api-docs.sitecore.com/sai/agent-api/briefs/briefs-generate_brief"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Generate a brief endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" going forward."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1briefs~1generate/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/GenerateBriefRequest"}},"schemaId":"components/schemas/GenerateBriefRequest","pointer":"/paths/~1api~1v1~1briefs~1generate/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/briefs/generate","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/GenerateBriefRequest"}},"responseCodes":["200","422"],"pointer":"/api/v1/briefs/generate","href":"briefs/briefs-generate_brief_deprecated","openApiOperationId":"briefs-generate_brief_deprecated","summary":"Generate a brief"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/GenerateBriefRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/GenerateBriefRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GenerateBriefResponse"}},"schemaId":"components/schemas/GenerateBriefResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1briefs~1generate/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/GenerateBriefResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GenerateBriefResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/briefs/briefs-generate_brief_deprecated"}],"panels":[]}]},"httpPath":"/api/v1/briefs/generate"}],"content":{"contentType":"group","meta":{"name":"Briefs"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Briefs","showPageActions":true},{"nodeType":"markdoc","content":"The Briefs API lets you retrieve available brief types, generate briefs based on a brief type and brand kit, create briefs and save it as a draft, and retrieve details of a specific brief."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v1/brief/brief-types","summary":"List brief types","prefix":{"name":"get","color":"get"},"badges":[],"link":"/briefs/list-brief_types","deprecated":false},{"title":"/api/v1/brief","summary":"List briefs","prefix":{"name":"get","color":"get"},"badges":[],"link":"/briefs/list-briefs","deprecated":false},{"title":"/api/v1/brief","summary":"Create a brief","prefix":{"name":"post","color":"post"},"badges":[],"link":"/briefs/brief-create_brief","deprecated":false},{"title":"/api/v1/brief/generate","summary":"Generate a brief","prefix":{"name":"post","color":"post"},"badges":[],"link":"/briefs/briefs-generate_brief","deprecated":false},{"title":"/api/v1/brief/brief-types/{brief_type_id}","summary":"Retrieve a brief type by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/briefs/get-brief_type_by_id","deprecated":false},{"title":"/api/v1/brief/{brief_id}","summary":"Retrieve a brief by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/briefs/get-brief_by_id","deprecated":false},{"title":"/api/v1/brief/{brief_id}","summary":"Update a brief","prefix":{"name":"put","color":"put"},"badges":[],"link":"/briefs/brief-update_brief","deprecated":false},{"title":"/api/v1/briefs/generate","summary":"Generate a brief","prefix":{"name":"post","color":"http-deprecated"},"badges":[],"link":"/briefs/briefs-generate_brief_deprecated","deprecated":true}]}]}]}]}},{"type":"group","label":"Experiments","link":"/sai/agent-api/experiments","routeSlug":"/sai/agent-api/experiments","items":[{"label":"Create an A/B/n test on a component","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/experiments/experiments-create_component_ab_test","routeSlug":"/sai/agent-api/experiments/experiments-create_component_ab_test","metadata":{"seo":{"title":"Create an A/B/n test on a component","description":"Creates a new A/B/n test for a specific component on a page. This allows you to compare two or more variants of the component and determine which one performs better."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"experiments-create_component_ab_test","name":"Create an A/B/n test on a component","isWebhook":false,"pointer":"/paths/~1api~1v1~1experiments~1flows/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create an A/B/n test on 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 new A/B/n test for a specific component on a page. This allows you to compare two or more variants of the component and determine which one performs better."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1experiments~1flows/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateExperimentRequest"}},"schemaId":"components/schemas/CreateExperimentRequest","pointer":"/paths/~1api~1v1~1experiments~1flows/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/experiments/flows","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateExperimentRequest"}},"responseCodes":["201","422"],"pointer":"/api/v1/experiments/flows","href":"experiments/experiments-create_component_ab_test","openApiOperationId":"experiments-create_component_ab_test","summary":"Create an A/B/n test on a component"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/CreateExperimentRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateExperimentRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExperimentFlowResponse"}},"schemaId":"components/schemas/ExperimentFlowResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1experiments~1flows/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/ExperimentFlowResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExperimentFlowResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/experiments/experiments-create_component_ab_test"}],"panels":[]}]},"httpPath":"/api/v1/experiments/flows"},{"label":"Update an A/B/n test on a component","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/experiments/experiments-update_ab_test","routeSlug":"/sai/agent-api/experiments/experiments-update_ab_test","metadata":{"seo":{"title":"Update an A/B/n test on a component","description":"Updates an existing A/B/n test for a specific component on a page. This allows you to modify the variants, targeting rules, or other settings of the test."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"experiments-update_ab_test","name":"Update an A/B/n test on a component","isWebhook":false,"pointer":"/paths/~1api~1v1~1experiments~1{flowId}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update an A/B/n test on a component","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Updates an existing A/B/n test for a specific component on a page. This allows you to modify the variants, targeting rules, or other settings of the test."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"flowId","in":"path","schemaId":"schema_1557","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the A/B/n test to update. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint for the page and use the flow "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value."},"children":[]}]}]}],"required":true,"example":"1fdfbc60-9646-469d-b971-2b0f4c033fbc"}],"pointer":"/paths/~1api~1v1~1experiments~1{flowId}/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1experiments~1{flowId}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateExperimentRequest"}},"schemaId":"components/schemas/UpdateExperimentRequest","pointer":"/paths/~1api~1v1~1experiments~1{flowId}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v1/experiments/{flowId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"flowId","in":"path","required":true,"example":"1fdfbc60-9646-469d-b971-2b0f4c033fbc","schemaId":"schema_1557"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateExperimentRequest"}},"responseCodes":["200","422"],"pointer":"/api/v1/experiments/{flowId}","href":"experiments/experiments-update_ab_test","openApiOperationId":"experiments-update_ab_test","summary":"Update an A/B/n test on a component"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/UpdateExperimentRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateExperimentRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExperimentFlowResponse"}},"schemaId":"components/schemas/ExperimentFlowResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1experiments~1{flowId}/put/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ExperimentFlowResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExperimentFlowResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/experiments/experiments-update_ab_test"}],"panels":[]}]},"httpPath":"/api/v1/experiments/{flowId}"}],"content":{"contentType":"group","meta":{"name":"Experiments"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Experiments","showPageActions":true},{"nodeType":"markdoc","content":"The Experiments API lets create A/B/n tests on components on a page and update an existing experiment."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v1/experiments/flows","summary":"Create an A/B/n test on a component","prefix":{"name":"post","color":"post"},"badges":[],"link":"/experiments/experiments-create_component_ab_test","deprecated":false},{"title":"/api/v1/experiments/{flowId}","summary":"Update an A/B/n test on a component","prefix":{"name":"put","color":"put"},"badges":[],"link":"/experiments/experiments-update_ab_test","deprecated":false}]}]}]}]}},{"type":"group","label":"Flow definitions","link":"/sai/agent-api/flow-definitions","routeSlug":"/sai/agent-api/flow-definitions","items":[{"label":"List flow definitions for a page","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/flow-definitions/flows-list_flow_definitions_by_page","routeSlug":"/sai/agent-api/flow-definitions/flows-list_flow_definitions_by_page","metadata":{"seo":{"title":"List flow definitions for a page","description":"Retrieves all flow definitions (both A/B/n tests and personalizations) for a specific page, including the structure, variants, and configuration details."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"flows-list_flow_definitions_by_page","name":"List flow definitions for a page","isWebhook":false,"pointer":"/paths/~1api~1v1~1flows~1by-page~1{pageId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List flow definitions for a page","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves all flow definitions (both A/B/n tests and  personalizations) for a specific page, including the structure, variants, and configuration details."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"pageId","in":"path","schemaId":"schema_1558","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page for which to retrieve flow definitions (A/B/n tests or personalizations). To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of pages for a specific site."},"children":[]}]}]}],"required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"}],"pointer":"/paths/~1api~1v1~1flows~1by-page~1{pageId}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"language","in":"query","schemaId":"schema_1559","description":"The language version of the page to filter flow definitions (A/B/n tests or personalizations).","example":"en"},{"name":"status","in":"query","schemaId":"schema_1560","description":"The status to filter flow definitions (A/B/n tests or personalizations), such as active, paused, or draft.","example":"active"}],"pointer":"/paths/~1api~1v1~1flows~1by-page~1{pageId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1flows~1by-page~1{pageId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/flows/by-page/{pageId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"pageId","in":"path","required":true,"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301","schemaId":"schema_1558"}],"query":[{"name":"language","in":"query","required":false,"example":"en","schemaId":"schema_1559"},{"name":"status","in":"query","required":false,"example":"active","schemaId":"schema_1560"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/flows/by-page/{pageId}","href":"flow-definitions/flows-list_flow_definitions_by_page","openApiOperationId":"flows-list_flow_definitions_by_page","summary":"List flow definitions for a page"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1561"}},"schemaId":"schema_1561"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1flows~1by-page~1{pageId}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1561","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1561"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/flow-definitions/flows-list_flow_definitions_by_page"}],"panels":[]}]},"httpPath":"/api/v1/flows/by-page/{pageId}"},{"label":"Retrieve a flow definition","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/flow-definitions/flows-get_flow_definition","routeSlug":"/sai/agent-api/flow-definitions/flows-get_flow_definition","metadata":{"seo":{"title":"Retrieve a flow definition","description":"Retrieves a specific flow definition (A/B/n test or personalization) on a page, including the structure, variants, and configuration details."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"flows-get_flow_definition","name":"Retrieve a flow definition","isWebhook":false,"pointer":"/paths/~1api~1v1~1flows~1{flowId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a flow definition","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves a specific flow definition (A/B/n test or personalization) on a page, including the structure, variants, and configuration details."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"flowId","in":"path","schemaId":"schema_1562","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the A/B/n test or personalization to retrieve. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint for the page and use the flow "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value."},"children":[]}]}]}],"required":true,"example":"1fdfbc60-9646-469d-b971-2b0f4c033fbc"}],"pointer":"/paths/~1api~1v1~1flows~1{flowId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1flows~1{flowId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/flows/{flowId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"flowId","in":"path","required":true,"example":"1fdfbc60-9646-469d-b971-2b0f4c033fbc","schemaId":"schema_1562"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/flows/{flowId}","href":"flow-definitions/flows-get_flow_definition","openApiOperationId":"flows-get_flow_definition","summary":"Retrieve a flow definition"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1563"}},"schemaId":"schema_1563"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1flows~1{flowId}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1563","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1563"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/flow-definitions/flows-get_flow_definition"}],"panels":[]}]},"httpPath":"/api/v1/flows/{flowId}"},{"label":"Reset component variant","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/flow-definitions/flows-reset_component_variant","routeSlug":"/sai/agent-api/flow-definitions/flows-reset_component_variant","metadata":{"seo":{"title":"Reset component variant","description":"Removes any applied personalization or A/B/n test variant set up, such as copy, hide, or swap, from a component and restores it to its original state."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"flows-reset_component_variant","name":"Reset component variant","isWebhook":false,"pointer":"/paths/~1api~1v1~1flows~1{flowId}~1variants~1reset/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Reset component variant","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Removes any applied personalization or A/B/n test variant set up, such as copy, hide, or swap, from a component and restores it to its original state."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"flowId","in":"path","schemaId":"schema_1564","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the A/B/n test or personalization that contains the variant to reset. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint for the page and use the flow "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1api~1v1~1flows~1{flowId}~1variants~1reset/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1534","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API."}],"pointer":"/paths/~1api~1v1~1flows~1{flowId}~1variants~1reset/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ResetComponentRequest"}},"schemaId":"components/schemas/ResetComponentRequest","pointer":"/paths/~1api~1v1~1flows~1{flowId}~1variants~1reset/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/flows/{flowId}/variants/reset","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"flowId","in":"path","required":true,"schemaId":"schema_1564"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"schemaId":"schema_1534"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ResetComponentRequest"}},"responseCodes":["201","422"],"pointer":"/api/v1/flows/{flowId}/variants/reset","href":"flow-definitions/flows-reset_component_variant","openApiOperationId":"flows-reset_component_variant","summary":"Reset component variant"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/ResetComponentRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ResetComponentRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ResetComponentResponse"}},"schemaId":"components/schemas/ResetComponentResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1flows~1{flowId}~1variants~1reset/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/ResetComponentResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ResetComponentResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/flow-definitions/flows-reset_component_variant"}],"panels":[]}]},"httpPath":"/api/v1/flows/{flowId}/variants/reset"},{"label":"Set up a component variant","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/flow-definitions/flows-setup_variant","routeSlug":"/sai/agent-api/flow-definitions/flows-setup_variant","metadata":{"seo":{"title":"Set up a component variant","description":"Sets up a variant for a specific A/B/n test or personalization by copying, hiding, or swapping the original component."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"flows-setup_variant","name":"Set up a component variant","isWebhook":false,"pointer":"/paths/~1api~1v1~1flows~1{flowId}~1variants~1{variantId}/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Set up a component variant","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Sets up a variant for a specific A/B/n test or personalization by copying, hiding, or swapping the original component."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"flowId","in":"path","schemaId":"schema_1565","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the A/B/n test or personalization to set up. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint for the page and use the flow "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value."},"children":[]}]}]}],"required":true,"example":"1fdfbc60-9646-469d-b971-2b0f4c033fbc"},{"name":"variantId","in":"path","schemaId":"schema_1566","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the personalization or A/B/n test variant to set up. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint. Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transpiledVariants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"variants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when available."},"children":[]}]}]}],"required":true,"example":"8ea2cb6f-a92a-4c05-88a3-a4c0b29c63a8"}],"pointer":"/paths/~1api~1v1~1flows~1{flowId}~1variants~1{variantId}/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1flows~1{flowId}~1variants~1{variantId}/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/SetupVariantRequest"}},"schemaId":"components/schemas/SetupVariantRequest","pointer":"/paths/~1api~1v1~1flows~1{flowId}~1variants~1{variantId}/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/flows/{flowId}/variants/{variantId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"flowId","in":"path","required":true,"example":"1fdfbc60-9646-469d-b971-2b0f4c033fbc","schemaId":"schema_1565"},{"name":"variantId","in":"path","required":true,"example":"8ea2cb6f-a92a-4c05-88a3-a4c0b29c63a8","schemaId":"schema_1566"}],"query":[],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/SetupVariantRequest"}},"responseCodes":["201","422"],"pointer":"/api/v1/flows/{flowId}/variants/{variantId}","href":"flow-definitions/flows-setup_variant","openApiOperationId":"flows-setup_variant","summary":"Set up a component variant"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"schemaId":"components/schemas/SetupVariantRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/SetupVariantRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SetupVariantResponse"}},"schemaId":"components/schemas/SetupVariantResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1flows~1{flowId}~1variants~1{variantId}/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/SetupVariantResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SetupVariantResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/flow-definitions/flows-setup_variant"}],"panels":[]}]},"httpPath":"/api/v1/flows/{flowId}/variants/{variantId}"},{"label":"Get flow definition variant details","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/agent-api/flow-definitions/flows-get_variant","routeSlug":"/sai/agent-api/flow-definitions/flows-get_variant","metadata":{"seo":{"title":"Get flow definition variant details","description":"Retrieves the details of a specific A/B/n test or personalization variant, including its datasource and components."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"flows-get_variant","name":"Get flow definition variant details","isWebhook":false,"pointer":"/paths/~1api~1v1~1flows~1{flowId}~1variants~1{variantId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get flow definition variant details","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves the details of a specific A/B/n test or personalization variant, including its datasource and components."},{"nodeType":"security","requirements":[{"schemes":[{"name":"HTTPBearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"flowId","in":"path","schemaId":"schema_1567","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the personalization or A/B/n test to retrieve. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for the page and use the flow "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value."},"children":[]}]}]}],"required":true,"example":"1fdfbc60-9646-469d-b971-2b0f4c033fbc"},{"name":"variantId","in":"path","schemaId":"schema_1568","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the personalization or A/B/n test variant to retrieve. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint. Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transpiledVariants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"variants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when available."},"children":[]}]}]}],"required":true,"example":"8ea2cb6f-a92a-4c05-88a3-a4c0b29c63a8"}],"pointer":"/paths/~1api~1v1~1flows~1{flowId}~1variants~1{variantId}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"language","in":"query","schemaId":"schema_1569","description":"The language version of the page for which to retrieve the variant details.","example":"en"},{"name":"version","in":"query","schemaId":"schema_1570","description":"The page version for which to retrieve the variant details. If not specified, the latest version will be used.","example":5}],"pointer":"/paths/~1api~1v1~1flows~1{flowId}~1variants~1{variantId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-sc-job-id","in":"header","schemaId":"schema_1464","description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","example":"job-1234"}],"pointer":"/paths/~1api~1v1~1flows~1{flowId}~1variants~1{variantId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/flows/{flowId}/variants/{variantId}","servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","description":"Production server"}],"parameters":{"path":[{"name":"flowId","in":"path","required":true,"example":"1fdfbc60-9646-469d-b971-2b0f4c033fbc","schemaId":"schema_1567"},{"name":"variantId","in":"path","required":true,"example":"8ea2cb6f-a92a-4c05-88a3-a4c0b29c63a8","schemaId":"schema_1568"}],"query":[{"name":"language","in":"query","required":false,"example":"en","schemaId":"schema_1569"},{"name":"version","in":"query","required":false,"example":5,"schemaId":"schema_1570"}],"querystring":[],"header":[{"name":"x-sc-job-id","in":"header","required":false,"example":"job-1234","schemaId":"schema_1464"}],"cookie":[]},"security":[{"schemes":[{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","422"],"pointer":"/api/v1/flows/{flowId}/variants/{variantId}","href":"flow-definitions/flows-get_variant","openApiOperationId":"flows-get_variant","summary":"Get flow definition variant details"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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 response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/VariantInfoResponse"}},"schemaId":"components/schemas/VariantInfoResponse"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}},"schemaId":"components/schemas/HTTPValidationError"}],"pointer":"/paths/~1api~1v1~1flows~1{flowId}~1variants~1{variantId}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/VariantInfoResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/VariantInfoResponse"}}},{"code":"422","schemaId":"components/schemas/HTTPValidationError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HTTPValidationError"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/flow-definitions/flows-get_variant"}],"panels":[]}]},"httpPath":"/api/v1/flows/{flowId}/variants/{variantId}"}],"content":{"contentType":"group","meta":{"name":"Flow definitions"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Flow definitions","showPageActions":true},{"nodeType":"markdoc","content":"The Flow definitions API lets you retrieve flow definitions (A/B/n tests and personalizations) for a specific page, configure their variants, and access detailed information about each variant."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v1/flows/by-page/{pageId}","summary":"List flow definitions for a page","prefix":{"name":"get","color":"get"},"badges":[],"link":"/flow-definitions/flows-list_flow_definitions_by_page","deprecated":false},{"title":"/api/v1/flows/{flowId}","summary":"Retrieve a flow definition","prefix":{"name":"get","color":"get"},"badges":[],"link":"/flow-definitions/flows-get_flow_definition","deprecated":false},{"title":"/api/v1/flows/{flowId}/variants/reset","summary":"Reset component variant","prefix":{"name":"post","color":"post"},"badges":[],"link":"/flow-definitions/flows-reset_component_variant","deprecated":false},{"title":"/api/v1/flows/{flowId}/variants/{variantId}","summary":"Set up a component variant","prefix":{"name":"post","color":"post"},"badges":[],"link":"/flow-definitions/flows-setup_variant","deprecated":false},{"title":"/api/v1/flows/{flowId}/variants/{variantId}","summary":"Get flow definition variant details","prefix":{"name":"get","color":"get"},"badges":[],"link":"/flow-definitions/flows-get_variant","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/AddComponentRequest":{"id":"components/schemas/AddComponentRequest","kind":"json-schema","title":"AddComponentRequest","data":{"properties":{"componentRenderingId":{"type":"string","format":"uuid","title":"Componentrenderingid","description":"The unique identifier of the component rendering definition.","example":"86a03271-dff4-470a-92bd-b68c67de2e25"},"placeholderPath":{"type":"string","title":"Placeholderpath","description":"The path of the placeholder where the component will be placed.","example":"/main/content"},"componentItemName":{"type":"string","title":"Componentitemname","description":"The name of the component item to create.","example":"New sidebar component"},"language":{"type":"string","title":"Language","description":"The language code for the component.","default":"en","example":"en"},"fields":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Fields","description":"Field values to set on the component or its datasource."},"insertBeforeComponentId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Insertbeforecomponentid","description":"The unique identifier of the component before which the new component will be inserted.","example":"9c6d53e3-fe57-4638-af7b-6d68304c7a94"},"insertAfterComponentId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Insertaftercomponentid","description":"The unique identifier of the component after which the new component will be inserted.","example":"9c6d53e3-fe57-4638-af7b-6d68304c7a94"}},"type":"object","required":["componentRenderingId","placeholderPath","componentItemName"],"title":"AddComponentRequest"}},"components/schemas/AddComponentResponse":{"id":"components/schemas/AddComponentResponse","kind":"json-schema","title":"AddComponentResponse","data":{"properties":{"componentId":{"type":"string","format":"uuid","title":"Componentid","description":"The unique identifier of the newly added component.","example":"d290f1ee-6c54-4b01-90e6-d701748f0851"},"pageId":{"type":"string","format":"uuid","title":"Pageid","description":"The unique identifier of the page to which the component was added.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"placeholderId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Placeholderid","description":"The unique identifier of the placeholder where the component was placed.","example":"123e4567-e89b-12d3-a456-426614174000"},"datasourceId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Datasourceid","description":"The unique identifier of the datasource used by the component, if applicable.","example":"9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f"}},"type":"object","title":"AddComponentResponse"}},"components/schemas/AddLanguageRequest":{"id":"components/schemas/AddLanguageRequest","kind":"json-schema","title":"AddLanguageRequest","data":{"properties":{"language":{"type":"string","title":"Language","description":"The language code of the new version to add.","default":"en","example":"en"}},"type":"object","title":"AddLanguageRequest"}},"components/schemas/AddLanguageResponse":{"id":"components/schemas/AddLanguageResponse","kind":"json-schema","title":"AddLanguageResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the language version was added successfully.","example":true}},"type":"object","title":"AddLanguageResponse"}},"components/schemas/AllowedChildTemplateModel":{"id":"components/schemas/AllowedChildTemplateModel","kind":"json-schema","title":"AllowedChildTemplateModel","data":{"properties":{"name":{"type":"string","title":"Name","description":"The name of the allowed child template.","example":"Full Width Page"},"templateId":{"type":"string","format":"uuid","title":"Templateid","description":"The unique identifier of the allowed child template.","example":"9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f"}},"type":"object","title":"AllowedChildTemplateModel"}},"components/schemas/AssetInformationMetadata":{"id":"components/schemas/AssetInformationMetadata","kind":"json-schema","title":"AssetInformationMetadata","data":{"properties":{"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width","description":"The width of the asset in pixels, or null if not applicable.","example":1920},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height","description":"The height of the asset in pixels, or null if not applicable.","example":1080},"format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Format","description":"The file format of the asset (e.g., jpg, png), or null if not applicable.","example":"jpg"},"alt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt Text","description":"Alternative text for the asset, or null if not provided.","example":"A beautiful sunset over the mountains."}},"type":"object","title":"AssetInformationMetadata"}},"components/schemas/AssetInformationResponse":{"id":"components/schemas/AssetInformationResponse","kind":"json-schema","title":"AssetInformationResponse","data":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"The unique identifier of the asset.","example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"The name of the asset.","example":"Sample Image"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","description":"The type of asset, for example, image or document.","example":"image"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"The URL where the asset can be accessed.","example":"https://example.com/assets/a1b2c3d4-e5f6-7890-abcd-ef1234567890"},"size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size","description":"The size of the asset in bytes.","example":204800},"metadata":{"anyOf":[{"$ref":"#/components/schemas/AssetInformationMetadata"},{"type":"null"}],"description":"Additional metadata about the asset."},"innerItem":{"anyOf":[{"$ref":"#/components/schemas/InnerItemModel"},{"type":"null"}],"description":"Details about the inner item if the asset is a container item."}},"type":"object","title":"AssetInformationResponse"}},"components/schemas/AssetMetadataModel":{"id":"components/schemas/AssetMetadataModel","kind":"json-schema","title":"AssetMetadataModel","data":{"properties":{"alt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt","description":"Alternative text for the asset, or null if not provided.","example":"A beautiful sunset over the mountains."},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width","description":"The width of the asset in pixels, or null if not applicable.","example":1920},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height","description":"The height of the asset in pixels, or null if not applicable.","example":1080},"extension":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Extension","description":"The file extension of the asset (e.g., jpg, png), or null if not applicable.","example":"jpg"},"size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size","description":"The size of the asset in bytes, or null if not applicable.","example":204800},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"A description of the asset, or null if not provided.","example":"This is a sample image used for demonstration purposes."}},"type":"object","title":"AssetMetadataModel"}},"components/schemas/AssetSearchResultModel":{"id":"components/schemas/AssetSearchResultModel","kind":"json-schema","title":"AssetSearchResultModel","data":{"properties":{"itemId":{"type":"string","format":"uuid","title":"Itemid","description":"The unique identifier of the asset.","example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890"},"path":{"type":"string","title":"Path","description":"The path of the asset in the content tree.","example":"/sitecore/media library/Images/Sample Image"},"name":{"type":"string","title":"Name","description":"The name of the asset.","example":"Sample Image"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayname","description":"The display name of the asset, or null if not set.","example":"Sample Image Display Name"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","description":"The type of asset such as image or document.","example":"image"},"templateId":{"type":"string","format":"uuid","title":"Templateid","description":"The unique identifier of the template used by the asset.","example":"9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f"},"templateName":{"type":"string","title":"Templatename","description":"The name of the template used by the asset.","example":"Image"},"innerItem":{"anyOf":[{"$ref":"#/components/schemas/AssetMetadataModel"},{"type":"null"}],"description":"Metadata about the asset."}},"type":"object","title":"AssetSearchResultModel"}},"components/schemas/Body_assets-upload_asset":{"id":"components/schemas/Body_assets-upload_asset","kind":"json-schema","title":"Body_assets-upload_asset","data":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"The file to upload as an asset. You must select a file from your local machine."},"upload_request":{"type":"string","title":"Upload Request","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A JSON string containing the following parameters for uploading an asset:"},"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":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the name of the asset."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"itemPath"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the path to the asset."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"language"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the language code of the asset."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"extension"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the asset's file extension."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"siteName"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the name of the site. process."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"JSON structure with example values:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n\"name\":  \"{YOUR_ASSETNAME}.jpg\",\n\"itemPath\": \"/sitecore/Media Library/Images\",\n\"language\": \"en\",\n\"extension\": \"jpg\",\n\"siteName\": \"skate-park\"\n}\n\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n\"name\":  \"{YOUR_ASSETNAME}.jpg\",\n\"itemPath\": \"/sitecore/Media Library/Images\",\n\"language\": \"en\",\n\"extension\": \"jpg\",\n\"siteName\": \"skate-park\"\n}\n\n"},"children":[]}]}],"example":"{\n  \"name\":\"homeimage.jpg\",\n \"itemPath\": \"/sitecore/Media Library/Images\",\n \"language\": \"en\",\n \"extension\": \"jpg\",\n \"siteName\": \"skate-park\"\n  }"}},"type":"object","required":["file","upload_request"],"title":"Body_assets-upload_asset"}},"components/schemas/BooleanConfig":{"id":"components/schemas/BooleanConfig","kind":"json-schema","title":"BooleanConfig","data":{"properties":{"type":{"type":"string","const":"Boolean","title":"Type","description":"The type of field in the brief type."},"name":{"type":"string","title":"Name","description":"The name of the field. Must be alphanumeric with no spaces or special characters.","example":"TargetAudience"},"label":{"additionalProperties":{"type":"string"},"type":"object","title":"Label","description":"The display label of the field, which can be localized for different languages.","example":{"en-us":"Target audience"}},"helpText":{"additionalProperties":{"type":"string"},"type":"object","title":"Helptext","description":"The text providing help or guidance for the field, which can be localized for different languages.","example":{"en-us":"Whether the campaign is targeting a specific audience."}},"required":{"type":"boolean","title":"Required","description":"Whether the field is required.","example":true},"aiEditable":{"type":"boolean","title":"Aieditable","description":"Whether the field is editable by AI.","example":false},"aiIntent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aiintent","description":"The AI intent associated with the field.","example":"This field should be used to adapt language and tone for the intended audience."}},"type":"object","title":"BooleanConfig"}},"components/schemas/BooleanFieldValue":{"id":"components/schemas/BooleanFieldValue","kind":"json-schema","title":"BooleanFieldValue","data":{"properties":{"type":{"type":"string","const":"Boolean","title":"Type","description":"The type of field in the brief type."},"value":{"type":"boolean","title":"Value","description":"The value of the field.","example":true}},"type":"object","required":["type","value"],"title":"BooleanFieldValue","description":"Boolean field value"}},"components/schemas/BrandContextBatchGetResponse":{"id":"components/schemas/BrandContextBatchGetResponse","kind":"json-schema","title":"BrandContextBatchGetResponse","data":{"properties":{"requested":{"type":"integer","title":"Requested","description":"The number of IDs requested.","example":3},"succeeded":{"type":"integer","title":"Succeeded","description":"The number of IDs whose fetch succeeded.","example":2},"failed":{"type":"integer","title":"Failed","description":"The number of IDs whose fetch failed.","example":1},"data":{"items":{"$ref":"#/components/schemas/BrandContextBatchItemResponse"},"type":"array","title":"Data","description":"One entry per requested ID, in the order requested. Each entry contains the fetched data for that ID, or an error if the fetch failed."}},"type":"object","title":"BrandContextBatchGetResponse","description":"Response model for the batch get items endpoint - completeness counts plus one entry\nper requested id, in the order requested."}},"components/schemas/BrandContextBatchItemResponse":{"id":"components/schemas/BrandContextBatchItemResponse","kind":"json-schema","title":"BrandContextBatchItemResponse","data":{"properties":{"brandContextItemId":{"type":"string","title":"Brandcontextitemid","description":"The unique identifier of the brand context item, which can be a folder or a file.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayname","description":"The display name of the folder or file.","example":"Audience Strategy"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","description":"The type of the brand context item. One of 'folder' or 'file'.","example":"file"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Markdown content of the brand context file. Null for folders, or when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fetchStatus"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"# Audience Strategy\n\n..."},"contentLength":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Contentlength","description":"The character count of the brand context file's content. Only present when content was fetched.","example":3480},"fetchStatus":{"$ref":"#/components/schemas/FetchStatus","description":"Whether this brand context item's fetch succeeded. Failed only on a genuine failure - a folder fetched successfully is 'succeeded' with content: null.","example":"succeeded"},"fetchStatusMessage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fetchstatusmessage","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The upstream error message for a failed fetch. Null when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fetchStatus"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"succeeded"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"Not found"},"createdDateTime":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Createddatetime","description":"Date and time the brand context item was created.","example":"2026-07-01T10:00:00Z"},"updatedDateTime":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updateddatetime","description":"Date and time the brand context item was last updated.","example":"2026-07-02T11:00:00Z"}},"type":"object","title":"BrandContextBatchItemResponse","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Model for a single item in a batch content fetch for brand context items. No children, this is a batch lookup by ID, not a tree traversal. Fields other than "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"brandContextItemId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fetchStatus"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fetchStatusMessage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are absent when the fetch itself failed."},"children":[]}]}]}]}},"components/schemas/BrandContextFileNode":{"id":"components/schemas/BrandContextFileNode","kind":"json-schema","title":"BrandContextFileNode","data":{"properties":{"brandContextItemId":{"type":"string","title":"Brandcontextitemid","description":"The unique identifier of the brand context item, which can be a folder or a file.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"displayName":{"type":"string","title":"Displayname","description":"The display name of the folder or file.","example":"persona-profiles"},"type":{"type":"string","const":"file","title":"Type","description":"Always 'file' for this node type.","example":"file"},"createdDateTime":{"type":"string","format":"date-time","title":"Createddatetime","description":"Date and time the brand context file was created.","example":"2026-07-01T10:00:00Z"},"updatedDateTime":{"type":"string","format":"date-time","title":"Updateddatetime","description":"Date and time the brand context file was last updated.","example":"2026-07-02T11:00:00Z"}},"type":"object","title":"BrandContextFileNode","description":"Model for a file in a brand context's nested tree index. No children field at all - files never have descendants. No content either."}},"components/schemas/BrandContextFolderNode":{"id":"components/schemas/BrandContextFolderNode","kind":"json-schema","title":"BrandContextFolderNode","data":{"properties":{"brandContextItemId":{"type":"string","title":"Brandcontextitemid","description":"The unique identifier of the brand context item, which can be a folder or a file.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"displayName":{"type":"string","title":"Displayname","description":"The display name of the folder or file.","example":"persona-profiles"},"type":{"type":"string","const":"folder","title":"Type","description":"Always 'folder' for this node type.","example":"folder"},"createdDateTime":{"type":"string","format":"date-time","title":"Createddatetime","description":"Date and time the brand context item was created.","example":"2026-07-01T10:00:00Z"},"updatedDateTime":{"type":"string","format":"date-time","title":"Updateddatetime","description":"Date and time the brand context item was last updated.","example":"2026-07-02T11:00:00Z"},"children":{"items":{"oneOf":[{"$ref":"#/components/schemas/BrandContextFolderNode"},{"$ref":"#/components/schemas/BrandContextFileNode"}],"discriminator":{"propertyName":"type","mapping":{"file":"#/components/schemas/BrandContextFileNode","folder":"#/components/schemas/BrandContextFolderNode"}}},"type":"array","title":"Children","description":"Nested folders or files. Always present, empty if this folder has no descendants.","default":[]}},"type":"object","title":"BrandContextFolderNode","description":"Model for a folder in a brand context's nested tree index. Can contain nested folders and files, but no content."}},"components/schemas/BriefFieldValue":{"id":"components/schemas/BriefFieldValue","kind":"json-schema","title":"BriefFieldValue","data":{"properties":{"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label","description":"The display label for the field.","example":"Objectives"},"type":{"type":"string","title":"Type","description":"The type of field in the brief.","example":"RichText"},"value":{"title":"Value","description":"The generated content for the field.","example":"The holiday campaign aims to inspire and empower audiences to embrace a healthier and more energetic lifestyle."}},"additionalProperties":true,"type":"object","title":"BriefFieldValue","description":"Model for individual brief field values."}},"components/schemas/BriefTypeLink":{"id":"components/schemas/BriefTypeLink","kind":"json-schema","title":"BriefTypeLink","data":{"properties":{"type":{"type":"string","title":"Type"},"relatedType":{"type":"string","title":"Relatedtype"},"id":{"type":"string","title":"Id"},"uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Uri"}},"type":"object","title":"BriefTypeLink"}},"components/schemas/BriefTypeModel":{"id":"components/schemas/BriefTypeModel","kind":"json-schema","title":"BriefTypeModel","data":{"properties":{"id":{"type":"string","title":"Id","description":"The unique UUID of the brief type.","example":"f2657200-e881-4027-8ddf-a9810eb9d177"},"name":{"type":"string","title":"Name","description":"The name of the brief type.","example":"travel_campaigns"},"label":{"additionalProperties":{"type":"string"},"type":"object","title":"Label","description":"The label of the brief type, which can be localized for different languages.","example":{"en-us":"Travel campaigns"}},"icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon","description":"The name of the icon associated with the brief type, which is used to visually represent the brief type in the UI.","example":"mdiFileDocumentOutline"},"iconColor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Iconcolor","description":"The color of the icon associated with the brief type.","example":"primary"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"The description of the brief type.","example":"Briefs used for planning and executing travel marketing campaigns."},"fields":{"items":{"oneOf":[{"$ref":"#/components/schemas/SimpleTextConfig"},{"$ref":"#/components/schemas/RichTextConfig"},{"$ref":"#/components/schemas/TimelineConfig"},{"$ref":"#/components/schemas/BudgetConfig"},{"$ref":"#/components/schemas/DateTimeConfig"},{"$ref":"#/components/schemas/BooleanConfig"}],"discriminator":{"propertyName":"type","mapping":{"Boolean":"#/components/schemas/BooleanConfig","Budget":"#/components/schemas/BudgetConfig","DateTime":"#/components/schemas/DateTimeConfig","RichText":"#/components/schemas/RichTextConfig","SimpleText":"#/components/schemas/SimpleTextConfig","Timeline":"#/components/schemas/TimelineConfig"}}},"type":"array","title":"Fields","description":"The list of fields that belong to this brief type, including their configurations and metadata."}},"type":"object","title":"BriefTypeModel"}},"components/schemas/BudgetConfig":{"id":"components/schemas/BudgetConfig","kind":"json-schema","title":"BudgetConfig","data":{"properties":{"type":{"type":"string","const":"Budget","title":"Type","description":"The type of field in the brief type."},"name":{"type":"string","title":"Name","description":"The name of the field. Must be alphanumeric with no spaces or special characters.","example":"TargetAudience"},"label":{"additionalProperties":{"type":"string"},"type":"object","title":"Label","description":"The display label of the field, which can be localized for different languages.","example":{"en-us":"Target audience"}},"helpText":{"additionalProperties":{"type":"string"},"type":"object","title":"Helptext","description":"The text providing help or guidance for the field, which can be localized for different languages.","example":{"en-us":"Describe the target audience for the content."}},"required":{"type":"boolean","title":"Required","description":"Whether the field is required.","example":true},"aiEditable":{"type":"boolean","title":"Aieditable","description":"Whether the field is editable by AI.","example":false},"aiIntent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aiintent","description":"The AI intent associated with the field.","example":"This field should be used to adapt language and tone for the intended audience."},"currencies":{"items":{"type":"string"},"type":"array","title":"Currencies","description":"A list of allowed currencies for the budget field, specified as ISO currency codes.","example":["USD","EUR"]}},"type":"object","title":"BudgetConfig"}},"components/schemas/BudgetFieldValue":{"id":"components/schemas/BudgetFieldValue","kind":"json-schema","title":"BudgetFieldValue","data":{"properties":{"type":{"type":"string","const":"Budget","title":"Type","description":"The type of the field value, which is always 'Budget' for this schema."},"value":{"$ref":"#/components/schemas/BudgetValue","description":"The budget amount and currency."}},"type":"object","required":["type","value"],"title":"BudgetFieldValue","description":"The Budget field value."}},"components/schemas/BudgetValue":{"id":"components/schemas/BudgetValue","kind":"json-schema","title":"BudgetValue","data":{"properties":{"amount":{"type":"number","title":"Amount","description":"The numeric amount of the budget.","example":10000},"currency":{"type":"string","title":"Currency","description":"The ISO currency code for the budget amount.","example":"USD"}},"type":"object","required":["amount","currency"],"title":"BudgetValue","description":"Budget field value"}},"components/schemas/ChildContentItemResponse":{"id":"components/schemas/ChildContentItemResponse","kind":"json-schema","title":"ChildContentItemResponse","data":{"properties":{"itemId":{"type":"string","format":"uuid","title":"Itemid","description":"The unique identifier of the content item.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"name":{"type":"string","title":"Name","description":"The name of the content item.","example":"New Article"},"path":{"type":"string","title":"Path","description":"The path of the content item in the content tree.","example":"/sitecore/content/Skate Park/Home/New Article"},"workflow":{"anyOf":[{"$ref":"#/components/schemas/WorkflowModel"},{"type":"null"}],"description":"The workflow information of the content item, or null if not in a workflow."},"version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Version","description":"The version number of the content item, or null if not applicable.","example":1},"template":{"$ref":"#/components/schemas/models__content__TemplateModel","description":"The template used by the content item."},"fields":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Fields","description":"A key-value map of field names and their values for the content item."},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At","description":"The timestamp when the content item was created.","example":"2025-01-15T10:30:00Z"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"The timestamp when the content item was updated.","example":"2025-01-15T10:30:00Z"}},"type":"object","title":"ChildContentItemResponse"}},"components/schemas/ComponentDetailsModel":{"id":"components/schemas/ComponentDetailsModel","kind":"json-schema","title":"ComponentDetailsModel","data":{"properties":{"itemId":{"type":"string","title":"Itemid","description":"The unique identifier of the item.","example":"d290f1ee-6c54-4b01-90e6-d701748f0851"},"name":{"type":"string","title":"Name","description":"The name of the item.","example":"Promo"},"displayName":{"type":"string","title":"Displayname","description":"The display name of the item.","example":"Promotional Banner"},"path":{"type":"string","title":"Path","description":"The path to the item.","example":"/sitecore/content/Home/Promotions/Banners/Promotional Banner"},"template":{"$ref":"#/components/schemas/ComponentTemplateModel","description":"The template used by the component."},"fields":{"$ref":"#/components/schemas/ComponentFields","description":"The fields associated with the component."}},"type":"object","title":"ComponentDetailsModel"}},"components/schemas/ComponentFields":{"id":"components/schemas/ComponentFields","kind":"json-schema","title":"ComponentFields","data":{"properties":{"nodes":{"items":{"$ref":"#/components/schemas/models__pages__FieldModel"},"type":"array","title":"Nodes","description":"A list of field nodes associated with the component."}},"type":"object","title":"ComponentFields"}},"components/schemas/ComponentGroup":{"id":"components/schemas/ComponentGroup","kind":"json-schema","title":"ComponentGroup","data":{"properties":{"title":{"type":"string","title":"Title","description":"The title of the component group.","example":"Dynamic Placeholders"},"components":{"items":{"$ref":"#/components/schemas/ComponentInfo"},"type":"array","title":"Components","description":"A list of components in the group."}},"type":"object","title":"ComponentGroup"}},"components/schemas/ComponentInfo":{"id":"components/schemas/ComponentInfo","kind":"json-schema","title":"ComponentInfo","data":{"properties":{"category":{"type":"string","title":"Category","description":"The category of the component.","example":"Dynamic Placeholders"},"displayName":{"type":"string","title":"Displayname","description":"The display name of the component.","example":"Partial Design Dynamic Placeholder"},"iconUrl":{"type":"string","title":"Iconurl","description":"The URL of the icon representing the component.","example":"/-/icon/Software/32x32/element.png.aspx"},"id":{"type":"string","format":"uuid","title":"Id","description":"The unique identifier of the component.","example":"86a03271-dff4-470a-92bd-b68c67de2e25"},"componentName":{"type":"string","title":"Componentname","description":"The internal name of the component.","example":"PartialDesignDynamicPlaceholder"}},"type":"object","title":"ComponentInfo"}},"components/schemas/ComponentModel":{"id":"components/schemas/ComponentModel","kind":"json-schema","title":"ComponentModel","data":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"The unique identifier of the component instance.","example":"d290f1ee-6c54-4b01-90e6-d701748f0851"},"componentId":{"type":"string","format":"uuid","title":"Componentid","description":"The unique identifier of the component rendering definition.","example":"86a03271-dff4-470a-92bd-b68c67de2e25"},"componentName":{"type":"string","title":"Componentname","description":"The internal name of the component.","example":"PartialDesignDynamicPlaceholder"},"dataSource":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Datasource","description":"The unique identifier of the datasource item used by the component, or null if not applicable.","example":"9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f"},"dataSourceItem":{"anyOf":[{"$ref":"#/components/schemas/DataSourceItemModel"},{"type":"null"}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The resolved datasource item, including its field values — the content this component displays. Null when the component has no datasource or it could not be resolved."},"children":[]}]}]}]},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Placeholder","description":"The path of the placeholder where the component is placed, or null if not applicable.","example":"/main/content"},"parameters":{"anyOf":[{"$ref":"#/components/schemas/ComponentParametersModel"},{"type":"null"}],"description":"Parameters configured for the component."},"deviceId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Deviceid","description":"The unique identifier of the device definition for which the component is configured, or null if not device-specific.","example":"123e4567-e89b-12d3-a456-426614174000"},"layoutId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Layoutid","description":"The unique identifier of the layout definition in which the component is placed, or null if not applicable.","example":"321e6547-e89b-12d3-a456-426614174000"},"componentDetails":{"anyOf":[{"$ref":"#/components/schemas/ComponentDetailsModel"},{"type":"null"}],"description":"Detailed information about the component item."},"editable":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Editable","description":"Whether the component is editable.","example":true}},"type":"object","title":"ComponentModel"}},"components/schemas/ComponentParametersModel":{"id":"components/schemas/ComponentParametersModel","kind":"json-schema","title":"ComponentParametersModel","data":{"properties":{"GridParameters":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gridparameters","description":"Grid parameters for the component, or null if not applicable.","example":"col-md-6"},"FieldNames":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fieldnames","description":"Field names associated with the component, or null if not applicable.","example":"Title, Description"},"Styles":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Styles","description":"The styles for the component, or null if not applicable.","example":"background-color: red; color: white;"},"RenderingIdentifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Renderingidentifier","description":"The unique identifier of the rendering, or null if not applicable.","example":"86a03271-dff4-470a-92bd-b68c67de2e25"},"CSSStyles":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cssstyles","description":"CSS styles for the component, or null if not applicable.","example":"font-size: 16px; margin: 10px;"},"DynamicPlaceholderId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dynamicplaceholderid","description":"The identifier for dynamic placeholders, or null if not applicable.","example":"placeholder-1234"}},"type":"object","title":"ComponentParametersModel"}},"components/schemas/ComponentResponse":{"id":"components/schemas/ComponentResponse","kind":"json-schema","title":"ComponentResponse","data":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"The unique identifier of the component.","example":"86a03271-dff4-470a-92bd-b68c67de2e25"},"name":{"type":"string","title":"Name","description":"The name of the component.","example":"Promo"},"datasourceTemplateId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Datasourcetemplateid","description":"The template ID for the component's datasource. May be None if the component has no datasource template.","example":"9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f"},"datasourceLocations":{"items":{"type":"string"},"type":"array","title":"Datasourcelocations","description":"A list of locations for the component's datasource.","example":["query:$site/*[@@name='Data']/*[@@templatename='Promo Folder']"]},"datasourceTemplatePath":{"type":"string","title":"Datasourcetemplatepath","description":"The path to the datasource template.","default":"","example":"Feature/JSS Experience Accelerator/Page Content/Promo"},"datasourceFields":{"items":{"$ref":"#/components/schemas/DatasourceFieldNode"},"type":"array","title":"Datasourcefields","description":"A list of fields for the datasource."},"datasourceAutoGenerated":{"type":"boolean","title":"Datasourceautogenerated","description":"Whether the datasource is auto-generated.","example":false},"datasourceRequired":{"type":"boolean","title":"Datasourcerequired","description":"Whether the datasource is required.","example":true},"hasDynamicPlaceholder":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Hasdynamicplaceholder","description":"Whether the component has a dynamic placeholder.","example":true}},"type":"object","title":"ComponentResponse"}},"components/schemas/ComponentShortInfo":{"id":"components/schemas/ComponentShortInfo","kind":"json-schema","title":"ComponentShortInfo","data":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"The unique identifier of the component.","example":"86a03271-dff4-470a-92bd-b68c67de2e25"},"name":{"type":"string","title":"Name","description":"The name of the component.","example":"Promo"}},"type":"object","title":"ComponentShortInfo"}},"components/schemas/ComponentTemplateModel":{"id":"components/schemas/ComponentTemplateModel","kind":"json-schema","title":"ComponentTemplateModel","data":{"properties":{"templateId":{"type":"string","format":"uuid","title":"Templateid","description":"The unique identifier of the template.","example":"9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f"},"name":{"type":"string","title":"Name","description":"The name of the template.","example":"Promo"}},"type":"object","title":"ComponentTemplateModel"}},"components/schemas/Components":{"id":"components/schemas/Components","kind":"json-schema","title":"Components","data":{"properties":{"groups":{"items":{"$ref":"#/components/schemas/ComponentGroup"},"type":"array","title":"Groups","description":"A list of component groups."},"ungrouped":{"items":{"$ref":"#/components/schemas/ComponentInfo"},"type":"array","title":"Ungrouped","description":"A list of ungrouped components.","default":[]}},"type":"object","title":"Components"}},"components/schemas/ComponentsResponse":{"id":"components/schemas/ComponentsResponse","kind":"json-schema","title":"ComponentsResponse","data":{"properties":{"components":{"$ref":"#/components/schemas/Components","description":"Components available for the specified site."}},"type":"object","title":"ComponentsResponse"}},"components/schemas/ConditionGroupInput":{"id":"components/schemas/ConditionGroupInput","kind":"json-schema","title":"ConditionGroupInput","data":{"properties":{"union_type":{"anyOf":[{"type":"string","enum":["AND","OR"]},{"type":"null"}],"title":"Union Type","description":"The union type for combining conditions within the group. Either 'AND' or 'OR'. The first group should not have a union type.","example":"AND"},"conditions":{"items":{"$ref":"#/components/schemas/ConditionInput"},"type":"array","title":"Conditions","description":"A list of conditions in this group."}},"type":"object","required":["conditions"],"title":"ConditionGroupInput","description":"Represents a group of conditions with a union type"}},"components/schemas/ConditionInput":{"id":"components/schemas/ConditionInput","kind":"json-schema","title":"ConditionInput","data":{"properties":{"condition_template_id":{"type":"string","format":"uuid","title":"Condition Template Id","description":"The unique identifier of the condition template to apply.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"condition_params":{"additionalProperties":true,"type":"object","title":"Condition Params","description":"A key-value map of parameters for the condition template.","example":{"timeOnSite":"30"}}},"type":"object","required":["condition_template_id","condition_params"],"title":"ConditionInput","description":"Represents a single condition in a condition group"}},"components/schemas/ConditionTemplate":{"id":"components/schemas/ConditionTemplate","kind":"json-schema","title":"ConditionTemplate","data":{"properties":{"href":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Href","description":"The URL of the condition template.","example":"https://www.example.com/condition-template"},"ref":{"type":"string","title":"Ref","description":"A reference identifier for the condition template.","example":"ConditionTemplate-12345"},"name":{"type":"string","title":"Name","description":"The name of the condition template.","example":"Time on Site"},"modifiedByRef":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Modifiedbyref","description":"A reference identifier for the user who last modified the condition template.","example":"User-67890"},"modifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Modifiedat","description":"The timestamp when the condition template was last modified.","example":"2025-01-15T10:30:00Z"},"revision":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Revision","description":"The revision number of the condition template.","example":3},"archived":{"type":"boolean","title":"Archived","description":"Whether the condition template is archived.","example":false},"friendlyId":{"type":"string","title":"Friendlyid","description":"A user-friendly identifier for the condition template.","example":"time_on_site"},"type":{"type":"string","title":"Type","description":"The type of the condition template.","example":"time-based"},"status":{"type":"string","title":"Status","description":"The status of the condition template.","example":"active"},"icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon","description":"The icon representing the condition template.","example":"https://www.example.com/icons/time-on-site.png"},"additionalFields":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Additionalfields","description":"A key-value map of additional fields for the condition template."},"templateElements":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Templateelements","description":"A list of template elements for the condition template."},"defaultTemplate":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Defaulttemplate","description":"Whether the condition template is the default.","example":false},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags","description":"A list of tags associated with the condition template."},"customTemplate":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Customtemplate","description":"Whether the condition template is custom.","example":true},"clientKey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Clientkey","description":"The client key for the condition template, or null if not applicable.","example":"pers123jgltUp"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"A description of the condition template, or null if not provided.","example":"This condition is based on the time a user spends on the site."},"revisionComment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Revisioncomment","description":"A comment about the revision of the condition template, or null if not provided.","example":"Updated time thresholds for better accuracy."},"render":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Render","description":"Whether to render the condition template, or null if not applicable.","example":true}},"type":"object","title":"ConditionTemplate"}},"components/schemas/ContentItemResponse":{"id":"components/schemas/ContentItemResponse","kind":"json-schema","title":"ContentItemResponse","data":{"properties":{"itemId":{"type":"string","format":"uuid","title":"Itemid","description":"The unique identifier of the content item.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"name":{"type":"string","title":"Name","description":"The name of the content item.","example":"New Article"},"path":{"type":"string","title":"Path","description":"The path of the content item in the content tree.","example":"/sitecore/content/Skate Park/Home/New Article"},"workflow":{"anyOf":[{"$ref":"#/components/schemas/WorkflowModel"},{"type":"null"}],"description":"The workflow information of the content item, or null if not in a workflow."},"version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Version","description":"The version number of the content item, or null if not applicable.","example":1},"template":{"$ref":"#/components/schemas/models__content__TemplateModel","description":"The template used by the content item."},"fields":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Fields","description":"A key-value map of field names and their values for the content item."},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At","description":"The timestamp when the content item was created.","example":"2025-01-15T10:30:00Z"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"The timestamp when the content item was updated.","example":"2025-01-15T10:30:00Z"},"children":{"anyOf":[{"additionalProperties":{"items":{"$ref":"#/components/schemas/ChildContentItemResponse"},"type":"array"},"type":"object"},{"type":"null"}],"title":"Children"}},"type":"object","title":"ContentItemResponse"}},"components/schemas/CreateBriefRequestModel":{"id":"components/schemas/CreateBriefRequestModel","kind":"json-schema","title":"CreateBriefRequestModel","data":{"properties":{"name":{"type":"string","title":"Name","description":"The name of the brief.","example":"New Summer Campaign Brief"},"locale":{"type":"string","pattern":"^[a-zA-Z]{2}-[a-zA-Z]{2}$","title":"Locale","description":"The locale code associated with the brief, in the format xx-XX.","example":"en-us"},"briefTypeId":{"type":"string","title":"Brieftypeid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the brief type to use for generating a brief. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/brieftypes-list_brieftypes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List brief types"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of brief types available in your organization."},"children":[]}]}]}],"example":"e7fe656b-178e-4ee2-86a9-ec800ff8a31d"},"fields":{"anyOf":[{"additionalProperties":{"oneOf":[{"$ref":"#/components/schemas/SimpleTextFieldValue"},{"$ref":"#/components/schemas/RichTextFieldValue"},{"$ref":"#/components/schemas/DateTimeFieldValue"},{"$ref":"#/components/schemas/BudgetFieldValue"},{"$ref":"#/components/schemas/BooleanFieldValue"},{"$ref":"#/components/schemas/TimelineFieldValue"}],"discriminator":{"propertyName":"type","mapping":{"Boolean":"#/components/schemas/BooleanFieldValue","Budget":"#/components/schemas/BudgetFieldValue","DateTime":"#/components/schemas/DateTimeFieldValue","RichText":"#/components/schemas/RichTextFieldValue","SimpleText":"#/components/schemas/SimpleTextFieldValue","Timeline":"#/components/schemas/TimelineFieldValue"}}},"type":"object"},{"type":"null"}],"title":"Fields","description":"Dictionary of field names to their values.","example":{"Objectives":{"type":"RichText","value":"New product campaign launch for Summer 2026."},"TargetAudience":{"type":"RichText","value":"Millenials"}}}},"type":"object","required":["name","locale","briefTypeId"],"title":"CreateBriefRequestModel","description":"Request model for creating a new brief"}},"components/schemas/CreateBriefResponseModel":{"id":"components/schemas/CreateBriefResponseModel","kind":"json-schema","title":"CreateBriefResponseModel","data":{"properties":{"id":{"type":"string","title":"Id","description":"The unique identifier of the created brief.","example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890"},"icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon","description":"The icon associated with the brief."},"name":{"type":"string","title":"Name","description":"The name of the brief.","example":"New Summer Campaign Brief"},"status":{"type":"string","title":"Status","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The status of the brief. "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Draft"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" by default."},"children":[]}]}]}],"example":"Draft"},"locale":{"type":"string","title":"Locale","description":"The locale code in the format xx-XX.","example":"en-us"},"fields":{"additionalProperties":true,"type":"object","title":"Fields","description":"Dictionary of field names to their values.","example":{"Objectives":{"type":"RichText","value":"New product campaign launch for Summer 2026."},"TargetAudience":{"type":"RichText","value":"Millenials"}}},"isTemplate":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Istemplate","description":"Whether the brief is a template","example":false},"contributors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Contributors","description":"A list of users who are contributors to the brief, or null if no contributors."},"createdBy":{"anyOf":[{"$ref":"#/components/schemas/ExternalLink"},{"type":"null"}],"description":"The user who created the brief."},"createdOn":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Createdon","description":"The ISO 8601 timestamp when the brief was created.","example":"2026-01-15T10:30:00Z"},"updatedBy":{"anyOf":[{"$ref":"#/components/schemas/ExternalLink"},{"type":"null"}],"description":"The user who last updated the brief."},"updatedOn":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatedon","description":"The ISO 8601 timestamp when the brief was last updated.","example":"2026-04-01T08:00:00Z"}},"type":"object","title":"CreateBriefResponseModel"}},"components/schemas/CreateComponentDatasourceRequest":{"id":"components/schemas/CreateComponentDatasourceRequest","kind":"json-schema","title":"CreateComponentDatasourceRequest","data":{"properties":{"siteName":{"type":"string","title":"Sitename","description":"The name of the site for which the datasource is created.","example":"skate-park"},"dataFields":{"additionalProperties":true,"type":"object","title":"Datafields","description":"A key-value map of data field names and their values for the datasource.","example":{"PromoText":"Summer Sale"}},"children":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Children","description":"A list of child datasource objects, or null if none."},"language":{"type":"string","title":"Language","description":"The language code for the datasource.","default":"en","example":"en"}},"type":"object","required":["siteName","dataFields"],"title":"CreateComponentDatasourceRequest"}},"components/schemas/CreateComponentDatasourceResponse":{"id":"components/schemas/CreateComponentDatasourceResponse","kind":"json-schema","title":"CreateComponentDatasourceResponse","data":{"properties":{"datasourceId":{"type":"string","format":"uuid","title":"Datasourceid","description":"The unique identifier of the created datasource.","example":"9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f"},"datasourceLocation":{"type":"string","title":"Datasourcelocation","description":"The location path of the created datasource.","example":"/sitecore/content/Verticals/SkatePark/Data/Promos"}},"type":"object","title":"CreateComponentDatasourceResponse"}},"components/schemas/CreateContentItemRequest":{"id":"components/schemas/CreateContentItemRequest","kind":"json-schema","title":"CreateContentItemRequest","data":{"properties":{"templateId":{"type":"string","format":"uuid","title":"Templateid","description":"The unique identifier of the template used to create the content item.","example":"9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f"},"name":{"type":"string","title":"Name","description":"The name of the content item to create.","example":"New Promo"},"parentId":{"type":"string","format":"uuid","title":"Parentid","description":"The unique identifier of the parent item.","example":"9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f"},"language":{"type":"string","title":"Language","description":"The language code for the content item.","default":"en","example":"en"},"fields":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Fields","description":"A key-value map of field names and their values for the content item, or null if none."}},"type":"object","required":["templateId","name","parentId"],"title":"CreateContentItemRequest"}},"components/schemas/CreateContentItemResponse":{"id":"components/schemas/CreateContentItemResponse","kind":"json-schema","title":"CreateContentItemResponse","data":{"properties":{"itemId":{"type":"string","format":"uuid","title":"Itemid","description":"The unique identifier of the created content item.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"name":{"type":"string","title":"Name","description":"The name of the created content item.","example":"New Promo"},"path":{"type":"string","title":"Path","description":"The path of the created content item.","example":"/sitecore/layout/Renderings/Feature/JSS Experience Accelerator/Page Content/Promo/New Promo"},"templateId":{"type":"string","format":"uuid","title":"Templateid","description":"The unique identifier of the template used for the content item.","example":"9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f"},"version":{"type":"integer","title":"Version","description":"The version number of the created content item.","example":1}},"type":"object","title":"CreateContentItemResponse"}},"components/schemas/CreateExperimentRequest":{"id":"components/schemas/CreateExperimentRequest","kind":"json-schema","title":"CreateExperimentRequest","data":{"properties":{"site_id":{"type":"string","title":"Site Id","description":"The unique identifier of the site. ","example":"site_123"},"page_id":{"type":"string","title":"Page Id","description":"The unique identifier of the page that includes the component to A/B/n test.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"The language code for the A/B/n test.","default":"en","example":"en"},"component_id":{"type":"string","title":"Component Id","description":"The unique identifier of the component to A/B/n test.","example":"d290f1ee-6c54-4b01-90e6-d701748f0851"},"name":{"type":"string","title":"Name","description":"The name of the A/B/n test.","example":"Hero Banner Experiment"},"goal_type":{"$ref":"#/components/schemas/GoalType","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How the A/B/n test evaluates the performance of its variants:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pageViewGoal"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - measures the number of page views."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bouncersGoal"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - measures the number of bounces."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"exitsGoal"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - measures the number of exits."},"children":[]}]}]}]}]},"targeted_pages":{"items":{"type":"string"},"type":"array","title":"Targeted Pages","description":"A list of page paths where you want to track the A/B/n test goal.","example":[]},"variants":{"items":{"$ref":"#/components/schemas/Variant"},"type":"array","title":"Variants","description":"A list of variants to use for the A/B/n test. Traffic splits must sum to 100 and exactly one variant must be marked as control."}},"type":"object","required":["site_id","page_id","component_id","name","goal_type","variants"],"title":"CreateExperimentRequest"}},"components/schemas/CreatePageRequest":{"id":"components/schemas/CreatePageRequest","kind":"json-schema","title":"CreatePageRequest","data":{"properties":{"templateId":{"type":"string","format":"uuid","title":"Templateid","description":"The unique identifier of the page template to be used for the new page.","example":"9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f"},"name":{"type":"string","title":"Name","description":"The name of the page to create.","example":"About Us"},"parentId":{"type":"string","format":"uuid","title":"Parentid","description":"The unique identifier of the parent item for the new page.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"language":{"type":"string","title":"Language","description":"The language code for the new page.","default":"en","example":"en"},"fields":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Fields","description":"A list of field objects to set on the page, or null if none."}},"type":"object","required":["templateId","name","parentId"],"title":"CreatePageRequest"}},"components/schemas/CreatePageResponse":{"id":"components/schemas/CreatePageResponse","kind":"json-schema","title":"CreatePageResponse","data":{"properties":{"itemId":{"type":"string","format":"uuid","title":"Itemid","description":"The unique identifier of the created page.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"name":{"type":"string","title":"Name","description":"The name of the created page.","example":"About Us"}},"type":"object","title":"CreatePageResponse"}},"components/schemas/CreatePersonalizationRequestV1":{"id":"components/schemas/CreatePersonalizationRequestV1","kind":"json-schema","title":"CreatePersonalizationRequestV1","data":{"properties":{"name":{"type":"string","title":"Name","description":"The name of the personalization rule.","example":"Summer Sale Personalization"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"The language code for the personalization rule, or null for default.","default":"en","example":"en"},"variant_name":{"type":"string","title":"Variant Name","description":"The name of the personalization variant.","example":"Summer Sale Variant"},"audience_name":{"type":"string","title":"Audience Name","description":"The name of the audience for the personalization rule.","example":"Returning Customers"},"condition_template_id":{"type":"string","format":"uuid","title":"Condition Template Id","description":"The unique identifier of the condition template to apply.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"condition_params":{"additionalProperties":true,"type":"object","title":"Condition Params","description":"A key-value map of parameters for the condition template.","example":{"timeOnSite":"30"}}},"type":"object","required":["name","variant_name","audience_name","condition_template_id","condition_params"],"title":"CreatePersonalizationRequestV1"}},"components/schemas/CreatePersonalizationRequestV2":{"id":"components/schemas/CreatePersonalizationRequestV2","kind":"json-schema","title":"CreatePersonalizationRequestV2","data":{"properties":{"name":{"type":"string","title":"Name","description":"The name of the personalization rule.","example":"Summer Sale Personalization"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"The language code for the personalization rule, or null for default.","default":"en","example":"en"},"variant_name":{"type":"string","title":"Variant Name","description":"The name of the personalization variant.","example":"Summer Sale Variant"},"audience_name":{"type":"string","title":"Audience Name","description":"The name of the audience for the personalization rule.","example":"Returning Customers"},"condition_groups":{"items":{"$ref":"#/components/schemas/ConditionGroupInput"},"type":"array","title":"Condition Groups","description":"List of condition groups with their conditions"}},"type":"object","required":["name","variant_name","audience_name","condition_groups"],"title":"CreatePersonalizationRequestV2"}},"components/schemas/DataSourceItemModel":{"id":"components/schemas/DataSourceItemModel","kind":"json-schema","title":"DataSourceItemModel","data":{"properties":{"itemId":{"type":"string","format":"uuid","title":"Itemid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the datasource item. Use this in the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/content-update_content"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Update a content item"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to edit the text shown on the page."},"children":[]}]}]}],"example":"7dd4de3d-de45-4989-ad71-a811181a7977"},"name":{"type":"string","title":"Name","description":"The name of the datasource item. Use this to distinguish between repeated components on the same page.","example":"Teaser Item5"},"path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Path","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The full path to the datasource item. Omitted on children — a child's path is its parent's path plus its name."},"children":[]}]}]}],"example":"/sitecore/content/Home/Solutions/Data/New Teaser Group"},"template":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Template","description":"The name of the template the datasource item uses. Omitted on children.","example":"Teaser Item"},"fields":{"additionalProperties":true,"type":"object","title":"Fields","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The datasource item's field values — the content actually shown on the page. Fields whose value is empty are omitted; call get_content_item_by_id on this item for the complete field list including empty ones."},"children":[]}]}]}],"default":{}},"children":{"anyOf":[{"items":{"$ref":"#/components/schemas/DataSourceItemModel"},"type":"array"},{"type":"null"}],"title":"Children","description":"Child items of the datasource, such as the individual teasers of a Teaser Group or tiles of a Tiles component. Page text often lives here rather than on the datasource itself."}},"type":"object","title":"DataSourceItemModel","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The item a component renders. This is where a page's visible text lives."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deliberately lean: this model is repeated once per component and once per child, so anything"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"carried here is multiplied across the whole page response. When the response grows past the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client's inlining limit it is written to a file instead, the caller compresses it by hand, and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the content gets dropped in the process — so size here is not cosmetic, it decides whether the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"content is usable at all. Children therefore omit "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"path"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"template"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which are derivable"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"from the parent, and empty field values are omitted everywhere."},"children":[]}]}]}]}},"components/schemas/DatasourceFieldNode":{"id":"components/schemas/DatasourceFieldNode","kind":"json-schema","title":"DatasourceFieldNode","data":{"properties":{"name":{"type":"string","title":"Name","description":"The name of the datasource field.","example":"PromoText"},"type":{"type":"string","title":"Type","description":"The type of datasource field.","example":"Rich Text"},"validation":{"type":"string","title":"Validation","description":"Validation rules for the datasource field.","example":""}},"type":"object","title":"DatasourceFieldNode"}},"components/schemas/DateTimeConfig":{"id":"components/schemas/DateTimeConfig","kind":"json-schema","title":"DateTimeConfig","data":{"properties":{"type":{"type":"string","const":"DateTime","title":"Type","description":"The type of field in the brief type."},"name":{"type":"string","title":"Name","description":"The name of the field. Must be alphanumeric with no spaces or special characters.","example":"TargetAudience"},"label":{"additionalProperties":{"type":"string"},"type":"object","title":"Label","description":"The display label of the field, which can be localized for different languages.","example":{"en-us":"Target audience"}},"helpText":{"additionalProperties":{"type":"string"},"type":"object","title":"Helptext","description":"The text providing help or guidance for the field, which can be localized for different languages.","example":{"en-us":"Describe the target audience for the content."}},"required":{"type":"boolean","title":"Required","description":"Whether the field is required.","example":true},"aiEditable":{"type":"boolean","title":"Aieditable","description":"Whether the field is editable by AI.","example":false},"aiIntent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aiintent","description":"The AI intent associated with the field.","example":"This field should be used to adapt language and tone for the intended audience."}},"type":"object","title":"DateTimeConfig"}},"components/schemas/DateTimeFieldValue":{"id":"components/schemas/DateTimeFieldValue","kind":"json-schema","title":"DateTimeFieldValue","data":{"properties":{"type":{"type":"string","const":"DateTime","title":"Type","description":"The type of field in the brief type."},"value":{"type":"string","title":"Value","description":"The value of the DateTime field.","example":"2025-01-15T10:30:00Z"}},"type":"object","required":["type","value"],"title":"DateTimeFieldValue","description":"DateTime field value"}},"components/schemas/DeleteContentResponse":{"id":"components/schemas/DeleteContentResponse","kind":"json-schema","title":"DeleteContentResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the content item was deleted successfully.","example":true},"deletedId":{"type":"string","format":"uuid","title":"Deletedid","description":"The unique identifier of the deleted content item.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"}},"type":"object","title":"DeleteContentResponse"}},"components/schemas/EditablePlaceholderModel":{"id":"components/schemas/EditablePlaceholderModel","kind":"json-schema","title":"EditablePlaceholderModel","data":{"properties":{"placeholderPath":{"type":"string","title":"Placeholderpath","description":"The full path of the placeholder.","example":"/headless-main/container-thirty-center-1"},"placeholderName":{"type":"string","title":"Placeholdername","description":"The name of the placeholder (last path segment).","example":"container-thirty-center-1"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayname","description":"The display name of the placeholder.","example":"container-thirty-center-1"}},"type":"object","title":"EditablePlaceholderModel"}},"components/schemas/ExperienceFlowDefinitionSplitV1":{"id":"components/schemas/ExperienceFlowDefinitionSplitV1","kind":"json-schema","title":"ExperienceFlowDefinitionSplitV1","data":{"properties":{"template":{"type":"string","title":"Template","description":"A serialized JSON payload for the split template. This payload typically includes variantId.","example":"{\"variantId\":\"6cc729784bee4851a7bc3352f90448bf_default\"}"},"variantName":{"type":"string","title":"Variantname","description":"The display name of the variant used in this split.","example":"Page 2 variant"},"audienceName":{"type":"string","title":"Audiencename","description":"The display name of the audience targeted by this split.","example":"Returning Visitors"},"conditionGroups":{"items":{"$ref":"#/components/schemas/FlowDefinitionConditionGroupV1"},"type":"array","title":"Conditiongroups","description":"The list of condition groups that determine when this split is eligible."}},"type":"object","title":"ExperienceFlowDefinitionSplitV1"}},"components/schemas/ExperienceFlowDefinitionSplitV2":{"id":"components/schemas/ExperienceFlowDefinitionSplitV2","kind":"json-schema","title":"ExperienceFlowDefinitionSplitV2","data":{"properties":{"template":{"type":"string","title":"Template","description":"A serialized JSON payload for the split template. This payload typically includes variantId.","example":"{\"variantId\":\"27f26f52b0ac40168aedb6eb15eff10f\"}"},"variantName":{"type":"string","title":"Variantname","description":"The display name of the variant used in this split.","example":"Page 2 variant"},"audienceName":{"type":"string","title":"Audiencename","description":"The display name of the audience targeted by this split.","example":"Returning Visitors"},"conditionGroups":{"items":{"$ref":"#/components/schemas/FlowDefinitionConditionGroupV2"},"type":"array","title":"Conditiongroups","description":"The list of condition groups that determine when this split is eligible."}},"type":"object","title":"ExperienceFlowDefinitionSplitV2"}},"components/schemas/ExperienceFlowResponseV1":{"id":"components/schemas/ExperienceFlowResponseV1","kind":"json-schema","title":"ExperienceFlowResponseV1","data":{"properties":{"clientKey":{"type":"string","title":"Clientkey","description":"The client key associated with the flow definition (A/B/n test or personalization).","example":"pers12345"},"href":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Href","description":"The URL of the flow definition (A/B/n test or personalization).","example":"https://www.example.com/flow-definition"},"ref":{"type":"string","title":"Ref","description":"A reference identifier for the flow definition (A/B/n test or personalization).","example":"FlowDefinition-12345"},"name":{"type":"string","title":"Name","description":"The name of the flow definition (A/B/n test or personalization).","example":"User Registration Flow"},"modifiedByRef":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Modifiedbyref","description":"A reference identifier for the user who last modified the flow definition (A/B/n test or personalization).","example":"User-67890"},"modifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Modifiedat","description":"The timestamp when the flow definition (A/B/n test or personalization) was last modified.","example":"2025-01-15T10:30:00Z"},"revision":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Revision","description":"The revision number of the flow definition (A/B/n test or personalization).","example":2},"archived":{"type":"boolean","title":"Archived","description":"Whether the flow definition (A/B/n test or personalization) is archived.","example":false},"friendlyId":{"type":"string","title":"Friendlyid","description":"A user-friendly identifier for the flow definition (A/B/n test or personalization).","example":"user_registration_flow"},"type":{"type":"string","title":"Type","description":"The type of the flow definition (A/B/n test or personalization).","example":"INTERACTIVE_API_FLOW"},"subtype":{"type":"string","title":"Subtype","description":"The subtype of the flow definition (A/B/n test or personalization).","example":"EXPERIENCE"},"channels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Channels","description":"A list of channels associated with the flow definition (A/B/n test or personalization), such as web or mobile."},"triggers":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Triggers","description":"A list of triggers for the flow definition (A/B/n test or personalization), or null if none."},"dashboardLinks":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Dashboardlinks","description":"A list of dashboard links for the experience (A/B/n test or personalization), or null if none."},"tags":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Tags","description":"A list of tags associated with the flow definition (A/B/n test or personalization), or null if none."},"businessProcess":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Businessprocess","description":"The business process associated with the flow definition (A/B/n test or personalization).","example":"user_registration"},"siteId":{"type":"string","title":"Siteid","description":"The unique identifier of the site associated with the A/B/n test or personalization.","example":"site_123"},"traffic":{"$ref":"#/components/schemas/ExperienceTrafficV1","description":"The traffic distribution configuration for the personalization experience (A/B/n test or personalization)."},"transpiledVariants":{"anyOf":[{"items":{},"type":"array","example":[{"name":"Page 2 variant","tasks":[{"implementation":"templateRenderTask","input":{"inputType":"templateRenderTaskInput","type":"application/json","template":"{\"variantId\":\"27f26f52b0ac40168aedb6eb15eff10f\"}"}}]}]},{"type":"null"}],"title":"Transpiledvariants","description":"A list of transpiled variants for the flow definition (A/B/n test or personalization), or null if none."},"variants":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Variants","description":"A list of variants for the flow definition (A/B/n test or personalization), or null if none."},"status":{"type":"string","title":"Status","description":"The current status of the flow definition (A/B/n test or personalization).","example":"DRAFT"},"schedule":{"anyOf":[{"$ref":"#/components/schemas/FlowDefinitionSchedule"},{"type":"null"}],"description":"The schedule configuration for the flow definition."},"revisions":{"anyOf":[{"$ref":"#/components/schemas/FlowDefinitionRevisions"},{"type":"null"}],"description":"Links to the revisions of the flow definition."},"sampleSizeConfig":{"anyOf":[{"$ref":"#/components/schemas/FlowDefinitionSampleSizeConfigV1"},{"type":"null"}],"description":"The sample size configuration for the flow definition."},"notificationEnabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Notificationenabled","description":"Whether notifications are enabled for the flow definition (A/B/n test or personalization)."}},"type":"object","title":"ExperienceFlowResponseV1","description":"Response model for the v1 create personalization endpoint, matching the pre-AI-6608 shape."}},"components/schemas/ExperienceFlowResponseV2":{"id":"components/schemas/ExperienceFlowResponseV2","kind":"json-schema","title":"ExperienceFlowResponseV2","data":{"properties":{"clientKey":{"type":"string","title":"Clientkey","description":"The client key associated with the flow definition (A/B/n test or personalization).","example":"pers12345"},"href":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Href","description":"The URL of the flow definition (A/B/n test or personalization).","example":"https://www.example.com/flow-definition"},"ref":{"type":"string","title":"Ref","description":"A reference identifier for the flow definition (A/B/n test or personalization).","example":"FlowDefinition-12345"},"name":{"type":"string","title":"Name","description":"The name of the flow definition (A/B/n test or personalization).","example":"User Registration Flow"},"modifiedByRef":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Modifiedbyref","description":"A reference identifier for the user who last modified the flow definition (A/B/n test or personalization).","example":"User-67890"},"modifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Modifiedat","description":"The timestamp when the flow definition was last modified (A/B/n test or personalization).","example":"2025-01-15T10:30:00Z"},"revision":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Revision","description":"The revision number of the flow definition (A/B/n test or personalization).","example":2},"archived":{"type":"boolean","title":"Archived","description":"Whether the flow definition (A/B/n test or personalization) is archived.","example":false},"friendlyId":{"type":"string","title":"Friendlyid","description":"A user-friendly identifier for the flow definition (A/B/n test or personalization).","example":"user_registration_flow"},"type":{"type":"string","title":"Type","description":"The type of the flow definition (A/B/n test or personalization).","example":"EMBEDDED"},"channels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Channels","description":"A list of channels associated with the flow definition (A/B/n test or personalization), such as web or mobile."},"triggers":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Triggers","description":"A list of triggers for the flow definition (A/B/n test or personalization), or null if none."},"tags":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Tags","description":"A list of tags associated with the flow definition (A/B/n test or personalization), or null if none."},"businessProcess":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Businessprocess","description":"The business process associated with the flow definition (A/B/n test or personalization).","example":"user_registration"},"siteId":{"type":"string","title":"Siteid","description":"The unique identifier of the site associated with A/B/n test or personalization.","example":"site_123"},"transpiledVariants":{"anyOf":[{"items":{},"type":"array","example":[{"name":"Page 2 variant","tasks":[{"implementation":"templateRenderTask","input":{"inputType":"templateRenderTaskInput","type":"application/json","template":"{\"variantId\":\"27f26f52b0ac40168aedb6eb15eff10f\"}"}}]}]},{"type":"null"}],"title":"Transpiledvariants","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A list of transpiled variants for the flow definition (A/B/n test or personalization), or null if none. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"variantId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is typically in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transpiledVariants[].tasks[].input.template"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as serialized JSON."},"children":[]}]}]}]},"variants":{"anyOf":[{"items":{},"type":"array","example":[]},{"type":"null"}],"title":"Variants","description":"A list of variants for the flow definition (A/B/n test or personalization), or null if none."},"status":{"type":"string","title":"Status","description":"The current status of the flow definition (A/B/n test or personalization).","example":"DRAFT"},"schedule":{"anyOf":[{"$ref":"#/components/schemas/FlowDefinitionSchedule"},{"type":"null"}],"description":"The schedule configuration for the flow definition (A/B/n test or personalization)."},"revisions":{"anyOf":[{"$ref":"#/components/schemas/FlowDefinitionRevisions"},{"type":"null"}],"description":"Links to the revisions of the flow definition."},"sampleSizeConfig":{"anyOf":[{"$ref":"#/components/schemas/FlowDefinitionSampleSizeConfigV2"},{"type":"null"}],"description":"The sample size configuration for the flow definition."},"notificationEnabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Notificationenabled","description":"Whether notifications are enabled for the flow definition (A/B/n test or personalization)."},"subtype":{"type":"string","const":"EXPERIENCE","title":"Subtype","description":"The subtype of the flow definition (A/B/n test or personalization), identifying it as a personalization experience.","example":"EXPERIENCE"},"traffic":{"$ref":"#/components/schemas/ExperienceTrafficV2","description":"The traffic distribution configuration for the personalization experience."},"dashboardLinks":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Dashboardlinks","description":"A list of dashboard links for the experience, or null if none."}},"type":"object","title":"ExperienceFlowResponseV2"}},"components/schemas/ExperienceTrafficV1":{"id":"components/schemas/ExperienceTrafficV1","kind":"json-schema","title":"ExperienceTrafficV1","data":{"properties":{"type":{"type":"string","title":"Type","description":"The type of traffic distribution for the flow definition (A/B/n test or personalization).","example":"unique"},"weightingAlgorithm":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Weightingalgorithm","description":"The algorithm used for weighting traffic distribution (A/B/n test or personalization).","example":"random"},"modifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Modifiedat","description":"The timestamp when the traffic distribution was last modified.","example":"2026-01-01T00:00:00Z"},"splits":{"items":{"$ref":"#/components/schemas/ExperienceFlowDefinitionSplitV1"},"type":"array","title":"Splits","description":"A list of traffic splits for each personalization experience variant (A/B/n test or personalization)."}},"type":"object","title":"ExperienceTrafficV1"}},"components/schemas/ExperienceTrafficV2":{"id":"components/schemas/ExperienceTrafficV2","kind":"json-schema","title":"ExperienceTrafficV2","data":{"properties":{"type":{"type":"string","title":"Type","description":"The type of traffic distribution for the flow definition (A/B/n test or personalization).","example":"audienceTraffic"},"weightingAlgorithm":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Weightingalgorithm","description":"The algorithm used for weighting traffic distribution.","example":"USER_DEFINED"},"modifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Modifiedat","description":"The timestamp when the traffic distribution was last modified.","example":"2023-01-01T00:00:00Z"},"splits":{"items":{"$ref":"#/components/schemas/ExperienceFlowDefinitionSplitV2"},"type":"array","title":"Splits","description":"A list of traffic splits for each personalization experience variant."}},"type":"object","title":"ExperienceTrafficV2"}},"components/schemas/ExperimentFlowDefinitionSplit":{"id":"components/schemas/ExperimentFlowDefinitionSplit","kind":"json-schema","title":"ExperimentFlowDefinitionSplit","data":{"properties":{"ref":{"type":"string","title":"Ref","description":"A reference identifier for the experiment variant.","example":"variant-abc"},"split":{"type":"integer","title":"Split","description":"The traffic allocation percentage for this experiment variant.","example":50}},"type":"object","title":"ExperimentFlowDefinitionSplit"}},"components/schemas/ExperimentFlowResponse":{"id":"components/schemas/ExperimentFlowResponse","kind":"json-schema","title":"ExperimentFlowResponse","data":{"properties":{"clientKey":{"type":"string","title":"Clientkey","description":"The client key associated with the flow definition (A/B/n test or personalization).","example":"pers12345"},"href":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Href","description":"The URL of the flow definition (A/B/n test or personalization).","example":"https://www.example.com/flow-definition"},"ref":{"type":"string","title":"Ref","description":"A reference identifier for the flow definition (A/B/n test or personalization).","example":"FlowDefinition-12345"},"name":{"type":"string","title":"Name","description":"The name of the flow definition (A/B/n test or personalization).","example":"User Registration Flow"},"modifiedByRef":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Modifiedbyref","description":"A reference identifier for the user who last modified the flow definition (A/B/n test or personalization).","example":"User-67890"},"modifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Modifiedat","description":"The timestamp when the flow definition (A/B/n test or personalization) was last modified.","example":"2025-01-15T10:30:00Z"},"revision":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Revision","description":"The revision number of the flow definition (A/B/n test or personalization).","example":2},"archived":{"type":"boolean","title":"Archived","description":"Whether the flow definition (A/B/n test or personalization) is archived.","example":false},"friendlyId":{"type":"string","title":"Friendlyid","description":"A user-friendly identifier for the flow definition (A/B/n test or personalization).","example":"user_registration_flow"},"type":{"type":"string","title":"Type","description":"The type of the flow definition (A/B/n test or personalization).","example":"COMPONENT"},"channels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Channels","description":"A list of channels associated with the flow definition (A/B/n test or personalization), such as web or mobile."},"triggers":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Triggers","description":"A list of triggers for the flow definition (A/B/n test or personalization), or null if none."},"tags":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Tags","description":"A list of tags associated with the flow definition (A/B/n test or personalization), or null if none."},"businessProcess":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Businessprocess","description":"The business process associated with the flow definition (A/B/n test or personalization).","example":"user_registration"},"siteId":{"type":"string","title":"Siteid","description":"The unique identifier of the site associated with the A/B/n test or personalization.","example":"site_123"},"transpiledVariants":{"anyOf":[{"items":{},"type":"array","example":[{"ref":"b0e8307e-6cde-4761-a80f-9331ae56bf11","name":"Variant A","isControl":false,"tasks":[{"implementation":"templateRenderTask","input":{"inputType":"templateRenderTaskInput","type":"application/json","template":"{\"variantId\":\"27f26f52b0ac40168aedb6eb15eff10f\"}"}}]}]},{"type":"null"}],"title":"Transpiledvariants","description":"A list of transpiled variants for the flow definition (A/B/n test or personalization), or null if none."},"variants":{"anyOf":[{"items":{"$ref":"#/components/schemas/ExperimentVariantModel"},"type":"array"},{"type":"null"}],"title":"Variants","description":"A list of variants for the experiment (A/B/n test or personalization), or null if none."},"status":{"type":"string","title":"Status","description":"The current status of the flow definition (A/B/n test or personalization).","example":"DRAFT"},"schedule":{"anyOf":[{"$ref":"#/components/schemas/FlowDefinitionSchedule"},{"type":"null"}],"description":"The schedule configuration for the flow definition (A/B/n test or personalization)."},"revisions":{"anyOf":[{"$ref":"#/components/schemas/FlowDefinitionRevisions"},{"type":"null"}],"description":"Links to the revisions of the flow definition (A/B/n test or personalization)."},"sampleSizeConfig":{"anyOf":[{"$ref":"#/components/schemas/FlowDefinitionSampleSizeConfigV2"},{"type":"null"}],"description":"The sample size configuration for the flow definition (A/B/n test or personalization)."},"notificationEnabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Notificationenabled","description":"Whether notifications are enabled for the flow definition (A/B/n test or personalization)."},"subtype":{"type":"string","const":"EXPERIMENT","title":"Subtype","description":"The subtype of the flow definition (A/B/n test or personalization), identifying it as an A/B experiment.","example":"EXPERIMENT"},"traffic":{"$ref":"#/components/schemas/ExperimentTraffic","description":"The traffic distribution configuration for the A/B/n test."},"goals":{"anyOf":[{"$ref":"#/components/schemas/ExperimentGoalModel"},{"type":"null"}],"description":"The goals tracked for the experiment, keyed by goal identifier."}},"type":"object","title":"ExperimentFlowResponse"}},"components/schemas/ExperimentGoalDefinition":{"id":"components/schemas/ExperimentGoalDefinition","kind":"json-schema","title":"ExperimentGoalDefinition","data":{"properties":{"type":{"type":"string","title":"Type","description":"The type of goal.","example":"pageViewGoal"},"name":{"type":"string","title":"Name","description":"The name of the goal.","example":"Page View Goal"},"friendlyId":{"type":"string","title":"Friendlyid","description":"A user-friendly identifier for the goal.","example":"page_view_goal"},"ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ref","description":"A reference identifier for the goal.","example":"goal-abc"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"A description of the goal, or null if not provided.","example":"Track page views for the experiment."},"goalCalculation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Goalcalculation","description":"A key-value map defining the calculation method for the goal."},"pageParameters":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Pageparameters","description":"A list of page parameters associated with the goal."}},"type":"object","title":"ExperimentGoalDefinition"}},"components/schemas/ExperimentGoalModel":{"id":"components/schemas/ExperimentGoalModel","kind":"json-schema","title":"ExperimentGoalModel","data":{"additionalProperties":{"$ref":"#/components/schemas/ExperimentGoalDefinition"},"type":"object","title":"ExperimentGoalModel"}},"components/schemas/ExperimentTaskInputModel":{"id":"components/schemas/ExperimentTaskInputModel","kind":"json-schema","title":"ExperimentTaskInputModel","data":{"properties":{"inputType":{"type":"string","title":"Inputtype","description":"The type of task input.","example":"templateRenderTaskInput"},"type":{"type":"string","title":"Type","description":"The MIME type of the task input payload.","example":"swap"},"template":{"type":"string","title":"Template","description":"A serialized JSON payload for the task template. For experiments, this typically includes a variantId value.","example":"{\"variantId\":\"6cc729784bee4851a7bc3352f90448bf_default\"}"}},"type":"object","title":"ExperimentTaskInputModel"}},"components/schemas/ExperimentTaskModel":{"id":"components/schemas/ExperimentTaskModel","kind":"json-schema","title":"ExperimentTaskModel","data":{"properties":{"implementation":{"type":"string","title":"Implementation","description":"The implementation type of the task.","example":"TemplateRenderTask"},"input":{"$ref":"#/components/schemas/ExperimentTaskInputModel","description":"The input configuration for the task."}},"type":"object","title":"ExperimentTaskModel"}},"components/schemas/ExperimentTraffic":{"id":"components/schemas/ExperimentTraffic","kind":"json-schema","title":"ExperimentTraffic","data":{"properties":{"type":{"type":"string","title":"Type","description":"The type of traffic distribution for the flow definition (A/B/n test or personalization).","example":"simpleTraffic"},"weightingAlgorithm":{"type":"string","enum":["USER_DEFINED","AUTO"],"title":"Weightingalgorithm","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The algorithm used for weighting traffic. Either 'USER_DEFINED' or 'AUTO'."},"children":[]}]}]}],"example":"USER_DEFINED"},"modifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Modifiedat","description":"The timestamp when the traffic distribution was last modified.","example":"2023-01-01T00:00:00Z"},"allocation":{"type":"integer","title":"Allocation","description":"The total traffic allocation percentage for the A/B/n test.","example":100},"coupled":{"type":"boolean","title":"Coupled","description":"Whether the traffic splits are coupled and adjusted together.","default":false,"example":false},"splits":{"items":{"$ref":"#/components/schemas/ExperimentFlowDefinitionSplit"},"type":"array","title":"Splits","description":"A list of traffic splits for each A/B/n test variant."}},"type":"object","title":"ExperimentTraffic"}},"components/schemas/ExperimentVariantModel":{"id":"components/schemas/ExperimentVariantModel","kind":"json-schema","title":"ExperimentVariantModel","data":{"properties":{"ref":{"type":"string","title":"Ref","description":"A reference identifier for the variant.","example":"variant-abc"},"name":{"type":"string","title":"Name","description":"The name of the variant.","example":"Variant A"},"isControl":{"type":"boolean","title":"Iscontrol","description":"Whether this is the control variant (baseline) for comparison in the A/B/n test.","example":false},"tasks":{"items":{"$ref":"#/components/schemas/ExperimentTaskModel"},"type":"array","title":"Tasks","description":"A list of tasks associated with the variant."}},"type":"object","title":"ExperimentVariantModel"}},"components/schemas/ExternalLink":{"id":"components/schemas/ExternalLink","kind":"json-schema","title":"ExternalLink","data":{"properties":{"type":{"type":"string","const":"ExternalLink","title":"Type","default":"ExternalLink","description":"The type of the link, which is always 'ExternalLink' for this model.","example":"ExternalLink"},"relatedSystem":{"$ref":"#/components/schemas/RelatedSystem"},"relatedType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Relatedtype","description":"The type of the related entity in the external system, or null if not specified.","example":"Dashboard"},"id":{"type":"string","title":"Id","description":"The unique identifier of the related entity in the external system.","example":"dashboard-12345"}},"type":"object","title":"ExternalLink","description":"Represents an external link with reference to external systems"}},"components/schemas/FetchStatus":{"id":"components/schemas/FetchStatus","kind":"json-schema","title":"FetchStatus","data":{"type":"string","enum":["succeeded","failed"],"description":"The status of the fetch operation, indicating whether it succeeded or failed.","title":"FetchStatus"}},"components/schemas/FlowDefinitionCondition":{"id":"components/schemas/FlowDefinitionCondition","kind":"json-schema","title":"FlowDefinitionCondition","data":{"properties":{"templateId":{"type":"string","title":"Templateid","description":"The unique identifier of the condition template.","example":"cond-6c54-4b01-90e6-d701748f0851"},"params":{"additionalProperties":{"type":"string"},"type":"object","title":"Params","description":"A key-value map of parameters for the condition."}},"type":"object","title":"FlowDefinitionCondition"}},"components/schemas/FlowDefinitionConditionGroupV1":{"id":"components/schemas/FlowDefinitionConditionGroupV1","kind":"json-schema","title":"FlowDefinitionConditionGroupV1","data":{"properties":{"conditions":{"items":{"$ref":"#/components/schemas/FlowDefinitionCondition"},"type":"array","title":"Conditions","description":"A list of conditions in this condition group."}},"type":"object","title":"FlowDefinitionConditionGroupV1"}},"components/schemas/FlowDefinitionConditionGroupV2":{"id":"components/schemas/FlowDefinitionConditionGroupV2","kind":"json-schema","title":"FlowDefinitionConditionGroupV2","data":{"properties":{"unionType":{"anyOf":[{"type":"string","enum":["AND","OR"]},{"type":"null"}],"title":"Uniontype","description":"Union type for combining conditions. Either AND or OR. First group should not have a unionType."},"conditions":{"items":{"$ref":"#/components/schemas/FlowDefinitionCondition"},"type":"array","title":"Conditions","description":"A list of conditions in this condition group."}},"type":"object","title":"FlowDefinitionConditionGroupV2"}},"components/schemas/FlowDefinitionRevisions":{"id":"components/schemas/FlowDefinitionRevisions","kind":"json-schema","title":"FlowDefinitionRevisions","data":{"properties":{"href":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Href","description":"The URL to access the revisions of the flow definition (A/B/n test or personalization).","example":"https://www.example.com/flow-definition/revisions"}},"type":"object","title":"FlowDefinitionRevisions"}},"components/schemas/FlowDefinitionSampleSizeConfigV1":{"id":"components/schemas/FlowDefinitionSampleSizeConfigV1","kind":"json-schema","title":"FlowDefinitionSampleSizeConfigV1","data":{"properties":{"baseValue":{"type":"number","title":"Basevalue","description":"The base value used for sample size calculation.","example":0.5},"minimumDetectableDifference":{"type":"number","title":"Minimumdetectabledifference","description":"The minimum detectable difference for the sample size calculation.","example":0.1},"confidenceLevel":{"type":"number","title":"Confidencelevel","description":"The confidence level for the sample size calculation.","example":0.95}},"type":"object","title":"FlowDefinitionSampleSizeConfigV1"}},"components/schemas/FlowDefinitionSampleSizeConfigV2":{"id":"components/schemas/FlowDefinitionSampleSizeConfigV2","kind":"json-schema","title":"FlowDefinitionSampleSizeConfigV2","data":{"properties":{"baseValue":{"type":"number","title":"Basevalue","description":"The base value used for sample size calculation.","example":0.5},"minimumDetectableDifference":{"type":"number","title":"Minimumdetectabledifference","description":"The minimum detectable difference for the sample size calculation.","example":0.1},"confidenceLevel":{"type":"number","title":"Confidencelevel","description":"The confidence level for the sample size calculation.","example":0.95},"sampleSize":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Samplesize","description":"The calculated sample size, or null if not yet computed."}},"type":"object","title":"FlowDefinitionSampleSizeConfigV2"}},"components/schemas/FlowDefinitionSchedule":{"id":"components/schemas/FlowDefinitionSchedule","kind":"json-schema","title":"FlowDefinitionSchedule","data":{"properties":{"type":{"type":"string","title":"Type","description":"The type of schedule for the flow definition (A/B/n test or personalization).","example":"simpleSchedule"},"startDate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Startdate","description":"The start date of the schedule.","example":"2023-01-01T00:00:00Z"}},"type":"object","title":"FlowDefinitionSchedule"}},"components/schemas/GenerateBriefRequest":{"id":"components/schemas/GenerateBriefRequest","kind":"json-schema","title":"GenerateBriefRequest","data":{"properties":{"briefTypeId":{"type":"string","title":"Brieftypeid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the brief type to use for generating a brief. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/brieftypes-list_brieftypes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List brief types"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of brief types available in your organization."},"children":[]}]}]}],"example":"e7fe656b-178e-4ee2-86a9-ec800ff8a31d"},"brandId":{"type":"string","title":"Brandid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the brand kit. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/brandkits-list_brandkits"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List brand kits"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of brand kits in your organization."},"children":[]}]}]}],"example":"b1234567-89ab-4cde-f012-3456789abcde"},"prompt":{"type":"string","title":"Prompt","description":"The prompt for brief generation. This provides AI the context or instructions for generating the brief.","example":"Generate a brief for the new holiday campaign."}},"type":"object","required":["briefTypeId","brandId","prompt"],"title":"GenerateBriefRequest","description":"Request model for generating a content brief"}},"components/schemas/GenerateBriefResponse":{"id":"components/schemas/GenerateBriefResponse","kind":"json-schema","title":"GenerateBriefResponse","data":{"additionalProperties":{"$ref":"#/components/schemas/BriefFieldValue"},"type":"object","title":"GenerateBriefResponse","description":"The response model for a generated content brief with dynamic field keys."}},"components/schemas/GetBrandContextResponse":{"id":"components/schemas/GetBrandContextResponse","kind":"json-schema","title":"GetBrandContextResponse","data":{"properties":{"brandContextId":{"type":"string","title":"Brandcontextid","description":"The unique identifier of the brand context.","example":"b1234567-89ab-4cde-f012-3456789abcde"},"displayName":{"type":"string","title":"Displayname","description":"The display name of the brand context.","example":"Contoso"},"sourceRef":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sourceref","description":"The source URL the brand context was bootstrapped from.","example":"https://www.contoso.com"},"runStatus":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Runstatus","description":"The status of the most recent bootstrap run.","example":"completed"},"createdDateTime":{"type":"string","format":"date-time","title":"Createddatetime","description":"Date and time the brand context was created.","example":"2026-07-01T10:00:00Z"},"updatedDateTime":{"type":"string","format":"date-time","title":"Updateddatetime","description":"Date and time the brand context was last updated.","example":"2026-07-02T11:00:00Z"},"children":{"items":{"oneOf":[{"$ref":"#/components/schemas/BrandContextFolderNode"},{"$ref":"#/components/schemas/BrandContextFileNode"}],"discriminator":{"propertyName":"type","mapping":{"file":"#/components/schemas/BrandContextFileNode","folder":"#/components/schemas/BrandContextFolderNode"}}},"type":"array","title":"Children","description":"The nested folder or file tree of the brand context.","default":[]}},"type":"object","title":"GetBrandContextResponse","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response model for the get brand context by ID endpoint - metadata + nested tree, no content."},"children":[]}]}]}]}},"components/schemas/GetBrandKitResponse":{"id":"components/schemas/GetBrandKitResponse","kind":"json-schema","title":"GetBrandKitResponse","data":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"The unique identifier of the brand kit.","example":"b1234567-89ab-4cde-f012-3456789abcde"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"The brand kit description.","example":"Brand kit for Contoso Corporation."},"name":{"type":"string","title":"Name","description":"The name of the brand kit.","example":"Contoso Brand Kit"},"brandName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brandname","description":"The name of the brand associated with the brand kit.","example":"Contoso"},"companyName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Companyname","description":"The name of the company associated with the brand kit.","example":"Contoso Corporation"},"status":{"type":"string","title":"Status","description":"The status of the brand kit.","example":"published"},"tags":{"anyOf":[{"items":{"$ref":"#/components/schemas/TagModel"},"type":"array"},{"type":"null"}],"title":"Tags","description":"A list of tags associated with the brand kit.","default":[]},"sections":{"anyOf":[{"items":{"$ref":"#/components/schemas/SectionModel"},"type":"array"},{"type":"null"}],"title":"Sections","description":"A list of sections in the brand kit.","default":[]}},"type":"object","title":"GetBrandKitResponse","description":"Response model for get brandkit by ID endpoint"}},"components/schemas/GetBriefResponse":{"id":"components/schemas/GetBriefResponse","kind":"json-schema","title":"GetBriefResponse","data":{"properties":{"id":{"type":"string","title":"Id","description":"The unique identifier of the brief.","example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890"},"icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon","description":"The icon associated with the brief."},"name":{"type":"string","title":"Name","description":"The name of the brief.","example":"New Summer Campaign Brief"},"status":{"type":"string","title":"Status","description":"The status of the brief. Draft by default.","example":"Draft"},"locale":{"type":"string","title":"Locale","description":"The locale code in the format xx-XX.","example":"en-us"},"fields":{"additionalProperties":true,"type":"object","title":"Fields","description":"Dictionary of field names to their values."},"isTemplate":{"type":"boolean","title":"Istemplate","default":false},"contributors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Contributors","description":"A list of contributors associated with the brief."},"createdBy":{"anyOf":[{"$ref":"#/components/schemas/ExternalLink"},{"type":"null"}],"description":"The user who created the brief.","example":"user-12345"},"createdOn":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Createdon","description":"The ISO 8601 timestamp when the brief was created.","example":"2026-01-15T10:30:00Z"},"updatedBy":{"anyOf":[{"$ref":"#/components/schemas/ExternalLink"},{"type":"null"}],"description":"The user who last updated the brief.","example":"user-67890"},"updatedOn":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatedon","description":"The ISO 8601 timestamp when the brief was last updated.","example":"2026-04-01T08:00:00Z"},"briefType":{"anyOf":[{"$ref":"#/components/schemas/BriefTypeLink"},{"type":"null"}]}},"type":"object","title":"GetBriefResponse"}},"components/schemas/GetBriefTypeResponse":{"id":"components/schemas/GetBriefTypeResponse","kind":"json-schema","title":"GetBriefTypeResponse","data":{"properties":{"id":{"type":"string","title":"Id","description":"The unique UUID of the brief type.","example":"f2657200-e881-4027-8ddf-a9810eb9d177"},"name":{"type":"string","title":"Name","description":"The name of the brief type.","example":"travel_campaigns"},"label":{"additionalProperties":{"type":"string"},"type":"object","title":"Label","description":"The label of the brief type, which can be localized for different languages.","example":{"en-us":"Travel campaigns"}},"icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon","description":"The name of the icon associated with the brief type, which is used to visually represent the brief type in the UI.","example":"mdiFileDocumentOutline"},"iconColor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Iconcolor","description":"The color of the icon associated with the brief type.","example":"primary"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"The description of the brief type.","example":"Briefs used for planning and executing travel marketing campaigns."},"fields":{"items":{"oneOf":[{"$ref":"#/components/schemas/SimpleTextConfig"},{"$ref":"#/components/schemas/RichTextConfig"},{"$ref":"#/components/schemas/TimelineConfig"},{"$ref":"#/components/schemas/BudgetConfig"},{"$ref":"#/components/schemas/DateTimeConfig"},{"$ref":"#/components/schemas/BooleanConfig"}],"discriminator":{"propertyName":"type","mapping":{"Boolean":"#/components/schemas/BooleanConfig","Budget":"#/components/schemas/BudgetConfig","DateTime":"#/components/schemas/DateTimeConfig","RichText":"#/components/schemas/RichTextConfig","SimpleText":"#/components/schemas/SimpleTextConfig","Timeline":"#/components/schemas/TimelineConfig"}}},"type":"array","title":"Fields","description":"The list of fields that belong to this brief type, including their configurations and metadata."}},"type":"object","title":"GetBriefTypeResponse","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response model for get brief type by ID — extends BriefTypeModel with audit fields"},"children":[]}]}]}]}},"components/schemas/GetPageComponentsResponse":{"id":"components/schemas/GetPageComponentsResponse","kind":"json-schema","title":"GetPageComponentsResponse","data":{"properties":{"pageId":{"type":"string","format":"uuid","title":"Pageid","description":"The unique identifier of the page.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"pageName":{"type":"string","title":"Pagename","description":"The name of the page.","example":"Home Page"},"pagePath":{"type":"string","title":"Pagepath","description":"The path to the page.","example":"/sitecore/content/Home"},"version":{"type":"integer","title":"Version","description":"The version number of the page.","example":1},"language":{"type":"string","title":"Language","description":"The language code of the page.","example":"en"},"route":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Route","description":"The route of the page, or null if not applicable.","example":"/home"},"layoutEditingKind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Layouteditingkind","description":"The layout editing kind of the page, or null if not applicable.","example":"Standard"},"template":{"anyOf":[{"$ref":"#/components/schemas/models__pages__TemplateModel"},{"type":"null"}],"description":"The template used for the page, or null if not applicable.","example":"Page Template"},"components":{"anyOf":[{"items":{"$ref":"#/components/schemas/ComponentModel"},"type":"array"},{"type":"null"}],"title":"Components","description":"A list of components on the page, or null if none.","default":[]}},"type":"object","title":"GetPageComponentsResponse"}},"components/schemas/GetPagePreviewUrlResponse":{"id":"components/schemas/GetPagePreviewUrlResponse","kind":"json-schema","title":"GetPagePreviewUrlResponse","data":{"properties":{"pageId":{"type":"string","format":"uuid","title":"Pageid","description":"The unique identifier of the page.","example":"f0b81bcc-7388-46be-b109-6e73d1114470"},"previewUrl":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Previewurl","description":"The preview URL of the page.","example":"https://preview.example.com/page/f0b81bc-7388-46be-b109-6e73d1114470"}},"type":"object","title":"GetPagePreviewUrlResponse"}},"components/schemas/GetPageResponse":{"id":"components/schemas/GetPageResponse","kind":"json-schema","title":"GetPageResponse","data":{"properties":{"itemId":{"type":"string","format":"uuid","title":"Itemid","description":"The unique identifier of the item.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"name":{"type":"string","title":"Name","description":"The name of the page.","example":"Home Page"},"templateId":{"type":"string","format":"uuid","title":"Templateid","description":"The template ID used for the page.","example":"9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f"},"locationPath":{"type":"string","title":"Locationpath","description":"The location path of the page in the content tree.","example":"/sitecore/content/Verticals/SkatePark/Home/Home Page"},"insertOptions":{"items":{"$ref":"#/components/schemas/PageInsertOptionModel"},"type":"array","title":"Insertoptions","description":"A list of options for inserting the page."},"editablePlaceholders":{"items":{"$ref":"#/components/schemas/EditablePlaceholderModel"},"type":"array","title":"Editableplaceholders","description":"Editable placeholders on the page."}},"type":"object","title":"GetPageResponse"}},"components/schemas/GoalType":{"id":"components/schemas/GoalType","kind":"json-schema","title":"GoalType","data":{"type":"string","enum":["pageViewGoal","bouncesGoal","exitsGoal"],"title":"GoalType"}},"components/schemas/HTTPValidationError":{"id":"components/schemas/HTTPValidationError","kind":"json-schema","title":"HTTPValidationError","data":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"}},"components/schemas/HideComponentRequest":{"id":"components/schemas/HideComponentRequest","kind":"json-schema","title":"HideComponentRequest","data":{"properties":{"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"Language code for the page","default":"en","example":"en"},"page_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Version","description":"The version of the page to use, or null for the latest version.","example":1}},"type":"object","title":"HideComponentRequest","description":"Request model for hiding a component on the Default variant"}},"components/schemas/HideComponentResponse":{"id":"components/schemas/HideComponentResponse","kind":"json-schema","title":"HideComponentResponse","data":{"properties":{"pageId":{"type":"string","format":"uuid","title":"Pageid","description":"The unique identifier of the page where the component was hidden.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"componentId":{"type":"string","format":"uuid","title":"Componentid","description":"The unique identifier of the component that was hidden.","example":"86a03271-dff4-470a-92bd-b68c67de2e25"},"language":{"type":"string","title":"Language","description":"The language of the page.","example":"en"}},"type":"object","title":"HideComponentResponse","description":"Response model for hide component operation"}},"components/schemas/InnerItemModel":{"id":"components/schemas/InnerItemModel","kind":"json-schema","title":"InnerItemModel","data":{"properties":{"displayName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Displayname","description":"The display name of the inner item, or null if not set.","example":"Promo Image"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height","description":"The height of the inner item, or null if not set.","example":250},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width","description":"The width of the inner item, or null if not set.","example":300}},"type":"object","title":"InnerItemModel"}},"components/schemas/InsertOptionModel":{"id":"components/schemas/InsertOptionModel","kind":"json-schema","title":"InsertOptionModel","data":{"properties":{"name":{"type":"string","title":"Name","description":"The name of the insert option.","example":"Full Width Page"},"templateId":{"type":"string","format":"uuid","title":"Templateid","description":"The unique identifier of the template used for the insert option.","example":"9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f"}},"type":"object","title":"InsertOptionModel"}},"components/schemas/LanguageModel":{"id":"components/schemas/LanguageModel","kind":"json-schema","title":"LanguageModel","data":{"properties":{"displayName":{"type":"string","title":"Displayname","description":"The display name of the language.","example":"English"},"iso":{"type":"string","title":"Iso","description":"The ISO code of the language.","example":"en"},"name":{"type":"string","title":"Name","description":"The name of the language.","example":"en"}},"type":"object","title":"LanguageModel"}},"components/schemas/ListBrandContextResponse":{"id":"components/schemas/ListBrandContextResponse","kind":"json-schema","title":"ListBrandContextResponse","data":{"properties":{"brandContextId":{"type":"string","title":"Brandcontextid","description":"The unique identifier of the brand context.","example":"b1234567-89ab-4cde-f012-3456789abcde"},"displayName":{"type":"string","title":"Displayname","description":"The display name of the brand context.","example":"Contoso"},"sourceRef":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sourceref","description":"The source URL the brand context was bootstrapped from. Null if it was not bootstrapped from a site.","example":"https://www.contoso.com"},"runStatus":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Runstatus","description":"The status of the most recent bootstrap run. Null if the brand context has never been bootstrapped.","example":"completed"},"createdDateTime":{"type":"string","format":"date-time","title":"Createddatetime","description":"Date and time the brand context was created.","example":"2026-07-01T10:00:00Z"},"updatedDateTime":{"type":"string","format":"date-time","title":"Updateddatetime","description":"Date and time the brand context was last updated.","example":"2026-07-02T11:00:00Z"}},"type":"object","title":"ListBrandContextResponse","description":"Model for a brand context summary (used in the list endpoint)"}},"components/schemas/ListBrandKitResponse":{"id":"components/schemas/ListBrandKitResponse","kind":"json-schema","title":"ListBrandKitResponse","data":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"The unique identifier of the brand kit.","example":"b1234567-89ab-4cde-f012-3456789abcde"},"name":{"type":"string","title":"Name","description":"The name of the brand kit.","example":"Contoso Brand Kit"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"The brand kit description.","example":"Brand kit for Contoso Corporation."},"brandName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brandname","description":"The name of the brand associated with the brand kit. Returns null if no brand name is set.","example":"Contoso"},"companyName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Companyname","description":"The name of the company associated with the brand kit. Returns null if no company name is set.","example":"Contoso Corporation"},"status":{"type":"string","title":"Status","description":"The status of the brand kit.","example":"published"},"tags":{"anyOf":[{"items":{"$ref":"#/components/schemas/TagModel"},"type":"array"},{"type":"null"}],"title":"Tags","description":"A list of tags associated with the brand kit.","default":[]}},"type":"object","title":"ListBrandKitResponse","description":"Model for brandkit summary (used in list endpoint)"}},"components/schemas/ListBriefTypesResponse":{"id":"components/schemas/ListBriefTypesResponse","kind":"json-schema","title":"ListBriefTypesResponse","data":{"properties":{"totalCount":{"type":"integer","title":"Totalcount","description":"The total number of available brief types.","example":5},"data":{"items":{"$ref":"#/components/schemas/BriefTypeModel"},"type":"array","title":"Data","description":"A list of available brief types."}},"type":"object","title":"ListBriefTypesResponse"}},"components/schemas/ListBriefsResponse":{"id":"components/schemas/ListBriefsResponse","kind":"json-schema","title":"ListBriefsResponse","data":{"properties":{"totalCount":{"type":"integer","title":"Totalcount","description":"The total number of briefs matching the query criteria.","example":10},"data":{"items":{"$ref":"#/components/schemas/GetBriefResponse"},"type":"array","title":"Data"}},"type":"object","title":"ListBriefsResponse"}},"components/schemas/ListSitesResponse":{"id":"components/schemas/ListSitesResponse","kind":"json-schema","title":"ListSitesResponse","data":{"properties":{"sites":{"items":{"$ref":"#/components/schemas/SiteBasicModel"},"type":"array","title":"Sites","description":"A list of sites."}},"type":"object","title":"ListSitesResponse"}},"components/schemas/MediaItem":{"id":"components/schemas/MediaItem","kind":"json-schema","title":"MediaItem","data":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"The unique identifier of the media item.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"embedUrl":{"type":"string","title":"Embedurl","description":"The URL to embed or access the media item.","example":"https://example.com/media/3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"size":{"type":"integer","title":"Size","description":"The size of the media item in bytes.","example":204800},"dimensions":{"type":"string","title":"Dimensions","description":"The dimensions of the media item.","example":"1920x1080"},"extension":{"type":"string","title":"Extension","description":"The file extension of the media item.","example":"mp4"}},"type":"object","title":"MediaItem"}},"components/schemas/NonVisualContentLocationModel":{"id":"components/schemas/NonVisualContentLocationModel","kind":"json-schema","title":"NonVisualContentLocationModel","data":{"properties":{"itemId":{"type":"string","format":"uuid","title":"Itemid","description":"The unique identifier of the item.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"name":{"type":"string","title":"Name","description":"The name of the item.","example":"Sample Item"},"path":{"type":"string","title":"Path","description":"The path to the item.","example":"/content/items/3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"allowed_child_content_templates":{"items":{"$ref":"#/components/schemas/AllowedChildTemplateModel"},"type":"array","title":"Allowed Child Content Templates","description":"A list of allowed child content templates."}},"type":"object","title":"NonVisualContentLocationModel"}},"components/schemas/PageHtmlResponse":{"id":"components/schemas/PageHtmlResponse","kind":"json-schema","title":"PageHtmlResponse","data":{"properties":{"pageId":{"type":"string","format":"uuid","title":"Pageid","description":"The unique identifier of the page.","example":"f0b81bcc-7388-46be-b109-6e73d1114470"},"html":{"type":"string","title":"Html","description":"The HTML content of the page.","example":"<html><body><h1>Webpage content</h1></body></html>"},"renderingHostUrl":{"type":"string","title":"Renderinghosturl","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The origin (scheme and host only) of the rendering host that produced html. Root-relative asset references in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"html"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are resolved against this origin, not the site's public hostname, which may point to a separate deployment with different build hashes. The value is empty if the origin cannot be determined, in which case callers should fall back rather than fail."},"children":[]}]}]}],"default":"","example":"https://xmc-example-site.sitecorecloud.io"}},"type":"object","title":"PageHtmlResponse","description":"Response model containing the HTML content of a page."}},"components/schemas/PageInsertOptionModel":{"id":"components/schemas/PageInsertOptionModel","kind":"json-schema","title":"PageInsertOptionModel","data":{"properties":{"templateId":{"type":"string","format":"uuid","title":"Templateid","description":"The unique identifier of the template.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"name":{"type":"string","title":"Name","description":"The name of the template.","example":"Full Width Page"}},"type":"object","title":"PageInsertOptionModel"}},"components/schemas/PageLocationModel":{"id":"components/schemas/PageLocationModel","kind":"json-schema","title":"PageLocationModel","data":{"properties":{"itemId":{"type":"string","format":"uuid","title":"Itemid","description":"The unique identifier of the item.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"name":{"type":"string","title":"Name","description":"The name of the item.","example":"Sample Item"},"path":{"type":"string","title":"Path","description":"The path to the item.","example":"/content/items/3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"allowed_child_page_templates":{"items":{"$ref":"#/components/schemas/AllowedChildTemplateModel"},"type":"array","title":"Allowed Child Page Templates","description":"A list of allowed child page templates."},"is_page_folder":{"type":"boolean","title":"Is Page Folder","description":"True when this location is a page folder (no presentation component); False for standard renderable pages.","default":false}},"type":"object","title":"PageLocationModel"}},"components/schemas/PageModel":{"id":"components/schemas/PageModel","kind":"json-schema","title":"PageModel","data":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"The unique identifier of the page.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"path":{"type":"string","title":"Path","description":"The path to the page.","example":"/content/pages/3f2504e0-4f89-11d3-9a0c-0305e82c3301"}},"type":"object","title":"PageModel"}},"components/schemas/PagePathByLiveUrlResponse":{"id":"components/schemas/PagePathByLiveUrlResponse","kind":"json-schema","title":"PagePathByLiveUrlResponse","data":{"properties":{"itemId":{"type":"string","format":"uuid","title":"Itemid","description":"The unique identifier of the page.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"name":{"type":"string","title":"Name","description":"The name of the page.","example":"Home"},"hasPresentation":{"type":"boolean","title":"Haspresentation","description":"Whether the page has presentation details.","example":true},"template":{"$ref":"#/components/schemas/PagePathTemplateModel","description":"The template details of the page."},"insertOptions":{"items":{"$ref":"#/components/schemas/PagePathInsertOptionModel"},"type":"array","title":"Insertoptions","description":"Insert options for the page."},"language":{"type":"string","title":"Language","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language in which the page was resolved. For locale-prefixed URLs, such as /fr/..., this reflects the language identified from the URL. Use the returned language value in subsequent requests to read or update the page’s field values for the correct language version; otherwise, the request may default to English."},"children":[]}]}]}],"default":"en","example":"en"}},"type":"object","title":"PagePathByLiveUrlResponse"}},"components/schemas/PagePathInsertOptionModel":{"id":"components/schemas/PagePathInsertOptionModel","kind":"json-schema","title":"PagePathInsertOptionModel","data":{"properties":{"name":{"type":"string","title":"Name","description":"The name of the insert option.","example":"Full Width Page"},"templateId":{"type":"string","format":"uuid","title":"Templateid","description":"The unique identifier of the template.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"}},"type":"object","title":"PagePathInsertOptionModel"}},"components/schemas/PagePathTemplateModel":{"id":"components/schemas/PagePathTemplateModel","kind":"json-schema","title":"PagePathTemplateModel","data":{"properties":{"templateId":{"type":"string","format":"uuid","title":"Templateid","description":"The unique identifier of the template.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"name":{"type":"string","title":"Name","description":"The name of the template.","example":"Full Width Page"}},"type":"object","title":"PagePathTemplateModel"}},"components/schemas/PageScreenshotResponse":{"id":"components/schemas/PageScreenshotResponse","kind":"json-schema","title":"PageScreenshotResponse","data":{"properties":{"type":{"type":"string","title":"Type","description":"The type of screenshot.","example":"png"},"fullPage":{"type":"boolean","title":"Fullpage","description":"Whether the screenshot is of the full page.","example":true},"encoding":{"type":"string","title":"Encoding","description":"The encoding format of the screenshot.","example":"base64"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"The timestamp when the screenshot was taken.","example":"2023-09-01T12:00:00Z"},"screenshot_base64":{"type":"string","title":"Screenshot Base64","description":"The base64-encoded screenshot data.","example":"iVBORw0KGgoAAAANSUhEUgAA..."}},"type":"object","title":"PageScreenshotResponse"}},"components/schemas/PageSearchItemModel":{"id":"components/schemas/PageSearchItemModel","kind":"json-schema","title":"PageSearchItemModel","data":{"properties":{"itemId":{"type":"string","format":"uuid","title":"Itemid","description":"The unique identifier of the item.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"name":{"type":"string","title":"Name","description":"The name of the item.","example":"Home"},"path":{"type":"string","title":"Path","description":"The path of the item.","example":"/sitecore/content/verticals/SkatePark/home"},"templateId":{"type":"string","format":"uuid","title":"Templateid","description":"The unique identifier of the template.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"fields":{"items":{"$ref":"#/components/schemas/models__pages__FieldModel"},"type":"array","title":"Fields","description":"A list of search fields associated with the item."}},"type":"object","title":"PageSearchItemModel"}},"components/schemas/PageTemplateFieldModel":{"id":"components/schemas/PageTemplateFieldModel","kind":"json-schema","title":"PageTemplateFieldModel","data":{"properties":{"name":{"type":"string","title":"Name","description":"The name of the field.","example":"Content"},"type":{"type":"string","title":"Type","description":"The field type.","example":"single-line text"},"validation":{"type":"boolean","title":"Validation","description":"Whether the field has validation rules.","example":false}},"type":"object","title":"PageTemplateFieldModel"}},"components/schemas/PageTemplateResponse":{"id":"components/schemas/PageTemplateResponse","kind":"json-schema","title":"PageTemplateResponse","data":{"properties":{"templateId":{"type":"string","format":"uuid","title":"Templateid","description":"The unique identifier of the template.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"name":{"type":"string","title":"Name","description":"The name of the template.","example":"Full Width Page"},"fields":{"items":{"$ref":"#/components/schemas/PageTemplateFieldModel"},"type":"array","title":"Fields","description":"A list of fields associated with the template."}},"type":"object","title":"PageTemplateResponse"}},"components/schemas/PersonalizationVariantDetailModelV1":{"id":"components/schemas/PersonalizationVariantDetailModelV1","kind":"json-schema","title":"PersonalizationVariantDetailModelV1","data":{"properties":{"page_id":{"type":"string","title":"Page Id","description":"The unique identifier of the page.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"variant_name":{"type":"string","title":"Variant Name","description":"The name of the variant.","example":"Variant A"},"audience_name":{"type":"string","title":"Audience Name","description":"The name of the audience targeted by the variant.","example":"Returning Visitors"},"template":{"type":"string","title":"Template","description":"The template used for the variant.","example":"Default Template"},"condition_groups":{"items":{"$ref":"#/components/schemas/FlowDefinitionConditionGroupV1"},"type":"array","title":"Condition Groups","description":"A list of condition groups for the personalization variant.","default":[]}},"type":"object","title":"PersonalizationVariantDetailModelV1"}},"components/schemas/PersonalizationVariantDetailModelV2":{"id":"components/schemas/PersonalizationVariantDetailModelV2","kind":"json-schema","title":"PersonalizationVariantDetailModelV2","data":{"properties":{"page_id":{"type":"string","title":"Page Id","description":"The unique identifier of the page.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"variant_name":{"type":"string","title":"Variant Name","description":"The name of the variant.","example":"Variant A"},"audience_name":{"type":"string","title":"Audience Name","description":"The name of the audience targeted by the variant.","example":"Returning Visitors"},"template":{"type":"string","title":"Template","description":"The template used for the variant.","example":"Default Template"},"condition_groups":{"items":{"$ref":"#/components/schemas/FlowDefinitionConditionGroupV2"},"type":"array","title":"Condition Groups","description":"A list of condition groups for the personalization variant.","default":[]}},"type":"object","title":"PersonalizationVariantDetailModelV2"}},"components/schemas/RelatedSystem":{"id":"components/schemas/RelatedSystem","kind":"json-schema","title":"RelatedSystem","data":{"type":"string","enum":["contenthub","mms","ai","xmcloud","co"],"title":"RelatedSystem","description":"Represents the related system reference for external links","example":"ai"}},"components/schemas/ResetComponentRequest":{"id":"components/schemas/ResetComponentRequest","kind":"json-schema","title":"ResetComponentRequest","data":{"properties":{"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"The language code for the page.","default":"en","example":"en"},"page_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Version","description":"The version of the page to use, or null for the latest version.","example":1},"page_id":{"type":"string","format":"uuid","title":"Page Id","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page containing the variant. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"component_id":{"type":"string","format":"uuid","title":"Component Id","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the component with personalization or A/B test variant to reset. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/pages-get_all_components_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List components of a page"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"429e3b45-277a-4c7f-adeb-4eb8b295d9ab"},"variant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variant Id","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the personalization or A/B testing variant to reset. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://api-docs.sitecore.com/sai/agent-api/flow-definitions/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint. Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transpiledVariants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"variants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when available."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you provide this value, the specified personalization or A/B test variant is reset. For personalization only, if you omit this value, the component on the default page variant is reset."},"children":[]}]}]}],"example":"429e3b45277a4c7fadeb4eb8b295d9ab_9d6f8492a3234b96b4c89878a8a1a7ab"}},"type":"object","required":["page_id","component_id"],"title":"ResetComponentRequest","description":"Request model for resetting a component variant in a flow"}},"components/schemas/ResetComponentResponse":{"id":"components/schemas/ResetComponentResponse","kind":"json-schema","title":"ResetComponentResponse","data":{"properties":{"pageId":{"type":"string","format":"uuid","title":"Pageid","description":"The unique identifier of the page where the component was reset","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"componentId":{"type":"string","format":"uuid","title":"Componentid","description":"The unique identifier of the component that was reset","example":"86a03271-dff4-470a-92bd-b68c67de2e25"},"language":{"type":"string","title":"Language","description":"The language of the page.","example":"en"}},"type":"object","title":"ResetComponentResponse","description":"Response model for reset component operation"}},"components/schemas/RichTextConfig":{"id":"components/schemas/RichTextConfig","kind":"json-schema","title":"RichTextConfig","data":{"properties":{"type":{"type":"string","const":"RichText","title":"Type","description":"The type of field in the brief type."},"name":{"type":"string","title":"Name","description":"The name of the field. Must be alphanumeric with no spaces or special characters.","example":"TargetAudience"},"label":{"additionalProperties":{"type":"string"},"type":"object","title":"Label","description":"The display label of the field, which can be localized for different languages.","example":{"en-us":"Target audience"}},"helpText":{"additionalProperties":{"type":"string"},"type":"object","title":"Helptext","description":"The help text for the field, which can be localized for different languages.","example":{"en-us":"Describe the target audience for the content, such as demographics, interests, and behaviors."}},"required":{"type":"boolean","title":"Required","description":"Whether the field is required.","example":true},"aiEditable":{"type":"boolean","title":"Aieditable","description":"Whether the field is editable by AI.","example":false},"aiIntent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aiintent","description":"The AI intent associated with the field.","example":"This field should be used to adapt language and tone for the intended audience."},"aiContext":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aicontext","description":"The AI context for the field.","example":"The content will be used in a hero banner on the homepage of an e-commerce website that sells healthy products."}},"type":"object","title":"RichTextConfig"}},"components/schemas/RichTextFieldValue":{"id":"components/schemas/RichTextFieldValue","kind":"json-schema","title":"RichTextFieldValue","data":{"properties":{"type":{"type":"string","const":"RichText","title":"Type","description":"The type of the field value."},"value":{"type":"string","title":"Value","description":"The rich text content of the field value.","example":"Emphasize the product benefits and features in the hero banner to attract customers."}},"type":"object","required":["type","value"],"title":"RichTextFieldValue","description":"Rich text field value"}},"components/schemas/SearchResponse":{"id":"components/schemas/SearchResponse","kind":"json-schema","title":"SearchResponse","data":{"properties":{"results":{"items":{"$ref":"#/components/schemas/SearchResult"},"type":"array","title":"Results","description":"A list of search results.","default":[]}},"type":"object","title":"SearchResponse"}},"components/schemas/SearchResult":{"id":"components/schemas/SearchResult","kind":"json-schema","title":"SearchResult","data":{"properties":{"itemId":{"type":"string","format":"uuid","title":"Itemid","description":"The unique identifier of the item.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"templateId":{"type":"string","format":"uuid","title":"Templateid","description":"The unique identifier of the template associated with the item.","example":"9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f"},"name":{"type":"string","title":"Name","description":"The name of the item.","example":"Hero Banner"}},"type":"object","title":"SearchResult"}},"components/schemas/SectionModel":{"id":"components/schemas/SectionModel","kind":"json-schema","title":"SectionModel","data":{"properties":{"id":{"type":"string","title":"Id","description":"The unique identifier of the brand kit section.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"name":{"type":"string","title":"Name","description":"The name of the brand kit section.","example":"Brand Context"},"fields":{"anyOf":[{"items":{"$ref":"#/components/schemas/models__brandkits__FieldModel"},"type":"array"},{"type":"null"}],"title":"Fields","description":"A list of brand kit fields (subsections).","default":[]}},"type":"object","title":"SectionModel","description":"Model for the brand kit sections."}},"components/schemas/SetComponentDatasourceRequest":{"id":"components/schemas/SetComponentDatasourceRequest","kind":"json-schema","title":"SetComponentDatasourceRequest","data":{"properties":{"datasourceId":{"type":"string","format":"uuid","title":"Datasourceid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the datasource to set for the component. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/datasources-list_datasources_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List datasources"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint."},"children":[]}]}]}],"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"The language for the datasource.","default":"en","example":"en"},"variantId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variantid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of personalization or A/B/n test variant to update. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint. Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transpiledVariants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"variants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when available."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you provide this value, the datasource update applies only to the specified variant. If you omit this value, the change applies to the base page."},"children":[]}]}]}],"example":"8bd7a9ec96b8490f9b894e3866fefb79_2a5c1e8c8d244f569a44d6b28cbecb05"}},"type":"object","required":["datasourceId"],"title":"SetComponentDatasourceRequest"}},"components/schemas/SetComponentDatasourceResponse":{"id":"components/schemas/SetComponentDatasourceResponse","kind":"json-schema","title":"SetComponentDatasourceResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the datasource was set successfully.","example":true},"message":{"type":"string","title":"Message","description":"A message providing additional information about the operation.","example":"Datasource set successfully."},"componentId":{"type":"string","format":"uuid","title":"Componentid","description":"The unique identifier of the component.","example":"86a03271-dff4-470a-92bd-b68c67de2e25"},"pageId":{"type":"string","format":"uuid","title":"Pageid","description":"The unique identifier of the page.","example":"9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f"},"datasourceId":{"type":"string","format":"uuid","title":"Datasourceid","description":"The unique identifier of the datasource.","example":"f0b81bcc-7388-46be-b109-6e73d1114470"}},"type":"object","title":"SetComponentDatasourceResponse"}},"components/schemas/SetupVariantRequest":{"id":"components/schemas/SetupVariantRequest","kind":"json-schema","title":"SetupVariantRequest","data":{"properties":{"page_id":{"type":"string","format":"uuid","title":"Page Id","description":"The unique identifier of the page containing the component.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"component_id":{"type":"string","title":"Component Id","description":"The unique identifier of the component to set up as a variant.","example":"d290f1ee-6c54-4b01-90e6-d701748f0851"},"variant_strategy":{"$ref":"#/components/schemas/VariantStrategy","description":"The strategy for the variant. Either HIDE, SWAP, or COPY."},"language":{"type":"string","title":"Language","description":"The language code for the variant setup.","default":"en","example":"en"},"page_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Version","description":"The version of the page to use, or null for the latest version.","example":1},"swapped_component":{"anyOf":[{"$ref":"#/components/schemas/SwappedComponentModel"},{"type":"null"}],"description":"The replacement component details when the variant strategy is SWAP, or null otherwise."}},"type":"object","required":["page_id","component_id","variant_strategy"],"title":"SetupVariantRequest"}},"components/schemas/SetupVariantResponse":{"id":"components/schemas/SetupVariantResponse","kind":"json-schema","title":"SetupVariantResponse","data":{"properties":{"pageId":{"type":"string","format":"uuid","title":"Pageid","description":"The unique identifier of the page.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"componentId":{"type":"string","format":"uuid","title":"Componentid","description":"The unique identifier of the component set up as a variant.","example":"d290f1ee-6c54-4b01-90e6-d701748f0851"},"componentRenderingId":{"type":"string","format":"uuid","title":"Componentrenderingid","description":"The unique identifier of the component rendering definition.","example":"86a03271-dff4-470a-92bd-b68c67de2e25"},"flowId":{"type":"string","title":"Flowid","description":"The unique identifier of the A/B/n test or personalization.","example":"1fdfbc60-9646-469d-b971-2b0f4c033fbc"},"variantId":{"type":"string","title":"Variantid","description":"The unique identifier of the A/B/n test or personalization variant.","example":"8ea2cb6f-a92a-4c05-88a3-a4c0b29c63a8"},"datasource":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Datasource","description":"The path to the datasource used by the variant, or null if not applicable.","example":"/sitecore/content/Verticals/SkatePark/Data/Promos/Summer Sale"}},"type":"object","title":"SetupVariantResponse"}},"components/schemas/SimpleTextConfig":{"id":"components/schemas/SimpleTextConfig","kind":"json-schema","title":"SimpleTextConfig","data":{"properties":{"type":{"type":"string","const":"SimpleText","title":"Type","description":"Type of the field the brief type."},"name":{"type":"string","title":"Name","description":"The name of the field. Must be alphanumeric with no spaces or special characters.","example":"TargetAudience"},"label":{"additionalProperties":{"type":"string"},"type":"object","title":"Label","description":"The display label of the field, which can be localized for different languages.","example":{"en-us":"Target audience"}},"helpText":{"additionalProperties":{"type":"string"},"type":"object","title":"Helptext","description":"The text providing help or guidance for the field, which can be localized for different languages.","example":{"en-us":"Describe the target audience for the content."}},"required":{"type":"boolean","title":"Required","description":"Whether the field is required.","example":true},"aiEditable":{"type":"boolean","title":"Aieditable","description":"Whether the field is editable by AI.","example":false},"aiIntent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aiintent","description":"The AI intent associated with the field.","example":"This field should be used to specify the message of the brief."},"aiContext":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aicontext","description":"The AI context for the field.","example":"null"}},"type":"object","title":"SimpleTextConfig"}},"components/schemas/SimpleTextFieldValue":{"id":"components/schemas/SimpleTextFieldValue","kind":"json-schema","title":"SimpleTextFieldValue","data":{"properties":{"type":{"type":"string","const":"SimpleText","title":"Type","description":"Type of the field value."},"value":{"type":"string","title":"Value","description":"The text value of the field.","example":"Message"}},"type":"object","required":["type","value"],"title":"SimpleTextFieldValue","description":"Simple text field value"}},"components/schemas/SiteBasicModel":{"id":"components/schemas/SiteBasicModel","kind":"json-schema","title":"SiteBasicModel","data":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"The unique identifier of the site.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"name":{"type":"string","title":"Name","description":"The name of the site.","example":"skate-park"},"targetHostname":{"type":"string","title":"Targethostname","description":"The target hostname of the site.","example":"skate-park.example.com"},"rootPath":{"type":"string","title":"Rootpath","description":"The root path of the site.","example":"/sitecore/content/SkatePark"}},"type":"object","title":"SiteBasicModel"}},"components/schemas/SiteIdFromItemResponse":{"id":"components/schemas/SiteIdFromItemResponse","kind":"json-schema","title":"SiteIdFromItemResponse","data":{"properties":{"siteRootItemId":{"type":"string","format":"uuid","title":"Siterootitemid","description":"The unique identifier of the site root item.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"siteRootDisplayName":{"type":"string","title":"Siterootdisplayname","description":"The display name of the site root.","example":"Skate Park"},"siteRootName":{"type":"string","title":"Siterootname","description":"The name of the site root.","example":"Skate Park"}},"type":"object","title":"SiteIdFromItemResponse"}},"components/schemas/SiteInformationResponse":{"id":"components/schemas/SiteInformationResponse","kind":"json-schema","title":"SiteInformationResponse","data":{"properties":{"itemId":{"type":"string","format":"uuid","title":"Itemid","description":"The unique identifier of the item.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"name":{"type":"string","title":"Name","description":"The name of the site.","example":"skate-park"},"brand_information":{"type":"string","title":"Brand Information","description":"Information about the brand associated with the site.","example":"Skate park brand guidelines"},"rootPath":{"type":"string","title":"Rootpath","description":"The root path of the site.","example":"/sitecore/content/SkatePark"},"page_locations":{"items":{"$ref":"#/components/schemas/PageLocationModel"},"type":"array","title":"Page Locations","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A list of page locations (pages and page folders) associated with the site. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"is_page_folder"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flag helps identify which ones are pages and which ones are page folders."},"children":[]}]}]}]},"non_visual_content_locations":{"items":{"$ref":"#/components/schemas/NonVisualContentLocationModel"},"type":"array","title":"Non Visual Content Locations","description":"A list of non-visual content locations associated with the site."}},"type":"object","title":"SiteInformationResponse"}},"components/schemas/SwappedComponentModel":{"id":"components/schemas/SwappedComponentModel","kind":"json-schema","title":"SwappedComponentModel","data":{"properties":{"componentRenderingId":{"type":"string","format":"uuid","title":"Componentrenderingid","description":"The unique identifier of the replacement component rendering definition.","example":"86a03271-dff4-470a-92bd-b68c67de2e25"},"datasourcePath":{"type":"string","title":"Datasourcepath","description":"The path to the datasource used by the swapped component.","example":"/sitecore/content/Verticals/SkatePark/Data/Promos/Summer Sale"}},"type":"object","required":["componentRenderingId","datasourcePath"],"title":"SwappedComponentModel"}},"components/schemas/TagModel":{"id":"components/schemas/TagModel","kind":"json-schema","title":"TagModel","data":{"properties":{"category":{"type":"string","title":"Category","description":"The tag category.","example":"audience"},"values":{"items":{"type":"string"},"type":"array","title":"Values","description":"A list of tag values for the category."}},"type":"object","title":"TagModel","description":"Model for brand kit tags with category and values"}},"components/schemas/TimelineCalculation":{"id":"components/schemas/TimelineCalculation","kind":"json-schema","title":"TimelineCalculation","data":{"type":"integer","enum":[0,1,2,3],"title":"TimelineCalculation","description":"Represents the timeline calculation constraint."}},"components/schemas/TimelineConfig":{"id":"components/schemas/TimelineConfig","kind":"json-schema","title":"TimelineConfig","data":{"properties":{"type":{"type":"string","const":"Timeline","title":"Type","description":"The type of field in the brief type."},"name":{"type":"string","title":"Name","description":"The name of the field. Must be alphanumeric with no spaces or special characters.","example":"TargetAudience"},"label":{"additionalProperties":{"type":"string"},"type":"object","title":"Label","description":"The display label of the field, which can be localized for different languages.","example":{"en-us":"Target audience"}},"helpText":{"additionalProperties":{"type":"string"},"type":"object","title":"Helptext","description":"The text providing help or guidance for the field, which can be localized for different languages.","example":{"en-us":"Describe the target audience for the content."}},"required":{"type":"boolean","title":"Required","description":"Whether the field is required.","example":true},"aiEditable":{"type":"boolean","title":"Aieditable","description":"Whether the field is editable by AI.","example":false},"aiIntent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aiintent","description":"The AI intent associated with the field.","example":"This field should be used to adapt language and tone for the intended audience."},"calculation":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The timeline calculation constraint. Either "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Flexible"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Backward"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Forward"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"Flexible"},"skipHolidays":{"type":"boolean","title":"Skipholidays","description":"Whether to skip holidays in timeline calculations.","example":true},"skipWeekend":{"type":"boolean","title":"Skipweekend","description":"Whether to skip weekends in timeline calculations.","example":true},"timezone":{"type":"string","title":"Timezone","description":"The timezone to use for timeline calculations."}},"type":"object","title":"TimelineConfig"}},"components/schemas/TimelineEvent":{"id":"components/schemas/TimelineEvent","kind":"json-schema","title":"TimelineEvent","data":{"properties":{"title":{"type":"string","title":"Title","description":"The title of the timeline event.","example":"Publish content"},"duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration","description":"The duration of the timeline event in the specified units.","example":7},"unit":{"anyOf":[{"$ref":"#/components/schemas/TimelineEventUnit"},{"type":"null"}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Timeline duration unit: Either "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Day"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Week"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"dueDate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Duedate","description":"The due date of the timeline event in yyyy-mm-dd format.","example":"2026-01-01"}},"type":"object","required":["title"],"title":"TimelineEvent","description":"Represents a timeline event."}},"components/schemas/TimelineEventUnit":{"id":"components/schemas/TimelineEventUnit","kind":"json-schema","title":"TimelineEventUnit","data":{"type":"string","enum":["Day","Week"],"title":"TimelineEventUnit","description":"Represents the units of time for timeline events."}},"components/schemas/TimelineFieldValue":{"id":"components/schemas/TimelineFieldValue","kind":"json-schema","title":"TimelineFieldValue","data":{"properties":{"type":{"type":"string","const":"Timeline","title":"Type","description":"The type of the field value"},"value":{"$ref":"#/components/schemas/TimelineValue","description":"The timeline value containing start date, end date, and events."}},"type":"object","required":["type","value"],"title":"TimelineFieldValue","description":"Timeline field value"}},"components/schemas/TimelineValue":{"id":"components/schemas/TimelineValue","kind":"json-schema","title":"TimelineValue","data":{"properties":{"startDate":{"type":"string","title":"Startdate","description":"The start date of the timeline in yyyy-mm-dd format.","example":"2025-09-01"},"endDate":{"type":"string","title":"Enddate","description":"The end date of the timeline in yyyy-mm-dd format.","example":"2025-09-07"},"events":{"items":{"$ref":"#/components/schemas/TimelineEvent"},"type":"array","title":"Events","description":"A list of events included in the timeline."}},"type":"object","title":"TimelineValue"}},"components/schemas/UpdateAssetRequest":{"id":"components/schemas/UpdateAssetRequest","kind":"json-schema","title":"UpdateAssetRequest","data":{"properties":{"fields":{"additionalProperties":true,"type":"object","title":"Fields","description":"A key-value map of metadata fields to update for the asset."},"language":{"type":"string","title":"Language","description":"The new language code of the asset.","example":"en"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"The new name for the asset. If null, the name will not be updated.","example":"Skateboarder"},"altText":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alttext","description":"The new alt text for the asset. If null, the alt text will not be updated.","default":"","example":"A skateboarder performing a trick"}},"type":"object","required":["fields","language"],"title":"UpdateAssetRequest"}},"components/schemas/UpdateAssetResponse":{"id":"components/schemas/UpdateAssetResponse","kind":"json-schema","title":"UpdateAssetResponse","data":{"properties":{"itemId":{"type":"string","format":"uuid","title":"Itemid","description":"The unique identifier of the asset.","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string","title":"Name","description":"The updated name of the asset.","example":"Skateboarder in action"},"path":{"type":"string","title":"Path","description":"The path to the asset.","example":"/media/assets/As8c7e6d-5b4"},"updatedFields":{"additionalProperties":true,"type":"object","title":"Updatedfields","description":"The fields that were updated in the asset."}},"type":"object","title":"UpdateAssetResponse"}},"components/schemas/UpdateBriefRequestModel":{"id":"components/schemas/UpdateBriefRequestModel","kind":"json-schema","title":"UpdateBriefRequestModel","data":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"The name of the brief","example":"New Summer Campaign Brief"},"fields":{"anyOf":[{"additionalProperties":{"oneOf":[{"$ref":"#/components/schemas/SimpleTextFieldValue"},{"$ref":"#/components/schemas/RichTextFieldValue"},{"$ref":"#/components/schemas/DateTimeFieldValue"},{"$ref":"#/components/schemas/BudgetFieldValue"},{"$ref":"#/components/schemas/BooleanFieldValue"},{"$ref":"#/components/schemas/TimelineFieldValue"}],"discriminator":{"propertyName":"type","mapping":{"Boolean":"#/components/schemas/BooleanFieldValue","Budget":"#/components/schemas/BudgetFieldValue","DateTime":"#/components/schemas/DateTimeFieldValue","RichText":"#/components/schemas/RichTextFieldValue","SimpleText":"#/components/schemas/SimpleTextFieldValue","Timeline":"#/components/schemas/TimelineFieldValue"}}},"type":"object"},{"type":"null"}],"title":"Fields","description":"Dictionary of field names to their values"}},"type":"object","title":"UpdateBriefRequestModel","description":"Model for updating an existing brief"}},"components/schemas/UpdateBriefResponse":{"id":"components/schemas/UpdateBriefResponse","kind":"json-schema","title":"UpdateBriefResponse","data":{"properties":{"id":{"type":"string","title":"Id","description":"The unique identifier of the brief.","example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890"},"icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon","description":"The icon associated with the brief."},"name":{"type":"string","title":"Name","description":"The name of the brief.","example":"New Summer Campaign Brief"},"status":{"type":"string","title":"Status","description":"The status of the brief. Draft by default.","example":"Draft"},"locale":{"type":"string","title":"Locale","description":"The locale code in the format xx-XX.","example":"en-us"},"fields":{"additionalProperties":true,"type":"object","title":"Fields","description":"Dictionary of field names to their values."},"isTemplate":{"type":"boolean","title":"Istemplate","default":false},"contributors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Contributors","description":"A list of users who contributed to the brief."},"createdBy":{"anyOf":[{"$ref":"#/components/schemas/ExternalLink"},{"type":"null"}],"description":"The user who created the brief."},"createdOn":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Createdon","description":"The ISO 8601 timestamp when the brief was created.","example":"2026-01-15T10:30:00Z"},"updatedBy":{"anyOf":[{"$ref":"#/components/schemas/ExternalLink"},{"type":"null"}],"description":"The user who last updated the brief."},"updatedOn":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatedon","description":"The ISO 8601 timestamp when the brief was last updated.","example":"2026-04-01T08:00:00Z"},"briefType":{"anyOf":[{"$ref":"#/components/schemas/BriefTypeLink"},{"type":"null"}]}},"type":"object","title":"UpdateBriefResponse"}},"components/schemas/UpdateContentRequest":{"id":"components/schemas/UpdateContentRequest","kind":"json-schema","title":"UpdateContentRequest","data":{"properties":{"fields":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Fields","description":"A key-value map of fields to update for the content item. If null, fields will not be updated."},"language":{"type":"string","title":"Language","description":"The language version of the content item to update.","default":"en","example":"en"},"createNewVersion":{"type":"boolean","title":"Createnewversion","description":"Whether to create a new version of the content item.","default":false,"example":false},"versionName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Versionname","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name for the new version, displayed beside the version number. This is only applicable if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"createNewVersion"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is true."},"children":[]}]}]}],"example":"AEO optimization"},"siteName":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sitename","description":"The unique name of the site where the content item resides.","example":"skate-park"}},"type":"object","title":"UpdateContentRequest"}},"components/schemas/UpdateContentResponse":{"id":"components/schemas/UpdateContentResponse","kind":"json-schema","title":"UpdateContentResponse","data":{"properties":{"itemId":{"type":"string","format":"uuid","title":"Itemid","description":"The unique identifier of the content item.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"name":{"type":"string","title":"Name","description":"The name of the content item.","example":"Sample Content Item"},"path":{"type":"string","title":"Path","description":"The path to the content item.","example":"/content/items/3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"updatedFields":{"additionalProperties":true,"type":"object","title":"Updatedfields","description":"The fields that were updated in the content item."},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"The language version used for the update.","example":"en"},"version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Version","description":"The item version the update was written to. A new version is created automatically when the item is in a final workflow state, so this may differ from the version you read.","example":3}},"type":"object","title":"UpdateContentResponse"}},"components/schemas/UpdateExperimentRequest":{"id":"components/schemas/UpdateExperimentRequest","kind":"json-schema","title":"UpdateExperimentRequest","data":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"The updated name of the A/B/n test.","example":"Latest Hero Banner Experiment"},"archived":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Archived","description":"Whether to archive the A/B/n test.","default":false,"example":false},"goal_type":{"anyOf":[{"$ref":"#/components/schemas/GoalType"},{"type":"null"}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How the A/B/n test evaluates the performance of its variants:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pageViewGoal"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - measures the number of page views."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bouncersGoal"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - measures the number of bounces."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"exitsGoal"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - measures the number of exits."},"children":[]}]}]}]}]},"targeted_pages":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Targeted Pages","description":"The updated list of page paths to target for the experiment.","example":[]},"variants":{"anyOf":[{"items":{"$ref":"#/components/schemas/Variant"},"type":"array"},{"type":"null"}],"title":"Variants","description":"An updated list of variants to use for the A/B/n test. Traffic splits must sum to 100 and exactly one variant must be marked as control."}},"type":"object","title":"UpdateExperimentRequest"}},"components/schemas/UpdatePersonalizationRequest":{"id":"components/schemas/UpdatePersonalizationRequest","kind":"json-schema","title":"UpdatePersonalizationRequest","data":{"properties":{"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"The language code for the personalization rule, or null for default.","default":"en","example":"en"},"variant_name":{"type":"string","title":"Variant Name","description":"The name of the personalization variant.","example":"Summer Sale Variant"},"audience_name":{"type":"string","title":"Audience Name","description":"The name of the audience for the personalization rule.","example":"Returning Customers"},"condition_groups":{"items":{"$ref":"#/components/schemas/ConditionGroupInput"},"type":"array","title":"Condition Groups","description":"List of condition groups with their conditions"}},"type":"object","required":["variant_name","audience_name","condition_groups"],"title":"UpdatePersonalizationRequest"}},"components/schemas/UploadAssetResponse":{"id":"components/schemas/UploadAssetResponse","kind":"json-schema","title":"UploadAssetResponse","data":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the asset upload was successful.","example":true},"mediaItem":{"$ref":"#/components/schemas/MediaItem","description":"The uploaded media item details."}},"type":"object","title":"UploadAssetResponse"}},"components/schemas/ValidationError":{"id":"components/schemas/ValidationError","kind":"json-schema","title":"ValidationError","data":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location","description":"The location of the error in the request."},"msg":{"type":"string","title":"Message","description":"The error message."},"type":{"type":"string","title":"Error Type","description":"The type of error."},"input":{"title":"Input","description":"The input that caused the error."},"ctx":{"type":"object","title":"Context","description":"The context in which the error occurred."}},"type":"object","title":"ValidationError"}},"components/schemas/Variant":{"id":"components/schemas/Variant","kind":"json-schema","title":"Variant","data":{"properties":{"name":{"type":"string","title":"Name","description":"The name of the variant.","example":"Variant A"},"is_control":{"type":"boolean","title":"Is Control","description":"Whether this is the control variant (baseline) for comparison in the A/B/n test.","example":false},"traffic_split":{"type":"number","title":"Traffic Split","description":"The percentage of traffic assigned to this variant. All variant splits must sum to 100.","example":50}},"type":"object","required":["name","is_control","traffic_split"],"title":"Variant"}},"components/schemas/VariantComponentModel":{"id":"components/schemas/VariantComponentModel","kind":"json-schema","title":"VariantComponentModel","data":{"properties":{"componentId":{"type":"string","format":"uuid","title":"Componentid","description":"The unique identifier of the component.","example":"d290f1ee-6c54-4b01-90e6-d701748f0851"},"componentRenderingId":{"type":"string","format":"uuid","title":"Componentrenderingid","description":"The unique identifier of the component rendering definition.","example":"86a03271-dff4-470a-92bd-b68c67de2e25"},"variantStrategy":{"anyOf":[{"$ref":"#/components/schemas/VariantStrategy"},{"type":"null"}],"description":"The variant strategy applied to this component. Either HIDE, SWAP, COPY, or null."},"datasourcePath":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Datasourcepath","description":"The path to the datasource used by the variant component, or null if not applicable.","example":"/sitecore/content/Verticals/SkatePark/Data/Promos/Summer Sale"},"componentName":{"type":"string","title":"Componentname","description":"The internal name of the component.","example":"Promo"}},"type":"object","title":"VariantComponentModel"}},"components/schemas/VariantInfoResponse":{"id":"components/schemas/VariantInfoResponse","kind":"json-schema","title":"VariantInfoResponse","data":{"properties":{"flowId":{"type":"string","title":"Flowid","description":"The unique identifier of the A/B/n test or personalization.","example":"1fdfbc60-9646-469d-b971-2b0f4c033fbc"},"variantId":{"type":"string","title":"Variantid","description":"The unique identifier of the A/B/n test or personalization variant.","example":"8ea2cb6f-a92a-4c05-88a3-a4c0b29c63a8"},"components":{"items":{"$ref":"#/components/schemas/VariantComponentModel"},"type":"array","title":"Components","description":"A list of components associated with the variant."}},"type":"object","title":"VariantInfoResponse"}},"components/schemas/VariantStrategy":{"id":"components/schemas/VariantStrategy","kind":"json-schema","title":"VariantStrategy","data":{"type":"string","enum":["HIDE","SWAP","COPY"],"title":"VariantStrategy"}},"components/schemas/WorkflowModel":{"id":"components/schemas/WorkflowModel","kind":"json-schema","title":"WorkflowModel","data":{"properties":{"workflowState":{"anyOf":[{"$ref":"#/components/schemas/WorkflowStateModel"},{"type":"null"}],"description":"The current workflow state of the content item."}},"type":"object","title":"WorkflowModel","description":"Model representing the workflow state of an item."}},"components/schemas/WorkflowStateModel":{"id":"components/schemas/WorkflowStateModel","kind":"json-schema","title":"WorkflowStateModel","data":{"properties":{"final":{"type":"boolean","title":"Final","description":"Whether this is a final workflow state.","example":false},"displayName":{"type":"string","title":"Displayname","description":"The display name of the workflow state.","example":"Published"}},"type":"object","title":"WorkflowStateModel"}},"components/schemas/models__brandkits__FieldModel":{"id":"components/schemas/models__brandkits__FieldModel","kind":"json-schema","title":"FieldModel","data":{"properties":{"id":{"type":"string","title":"Id","description":"The unique identifier of the brand kit field (subsection).","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"name":{"type":"string","title":"Name","description":"The name of the brand kit field.","example":"Brand purpose"},"type":{"type":"string","title":"Type","description":"The type of the brand kit field.","example":"text"},"value":{"anyOf":[{},{"type":"null"}],"title":"Value","description":"The value of the brand kit field.","example":"The core reason for the brand existence is to fuel the potential of active individuals with clean, nutrient-dense energy solutions."},"intent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intent","description":"The intent of the brand kit field.","example":"The core reason for the brand's existence."}},"type":"object","title":"FieldModel","description":"Model for the brand kit section field."}},"components/schemas/models__content__TemplateModel":{"id":"components/schemas/models__content__TemplateModel","kind":"json-schema","title":"TemplateModel","data":{"properties":{"templateId":{"type":"string","format":"uuid","title":"Templateid","description":"The unique identifier of the template.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"name":{"type":"string","title":"Name","description":"The name of the template.","example":"Article Page"}},"type":"object","title":"TemplateModel"}},"components/schemas/models__pages__FieldModel":{"id":"components/schemas/models__pages__FieldModel","kind":"json-schema","title":"FieldModel","data":{"properties":{"name":{"type":"string","title":"Name","description":"The name of the field.","example":"Title"},"value":{"type":"string","title":"Value","description":"The value of the field.","example":"Welcome to Our Site"}},"type":"object","title":"FieldModel"}},"components/schemas/models__pages__TemplateModel":{"id":"components/schemas/models__pages__TemplateModel","kind":"json-schema","title":"TemplateModel","data":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"The unique identifier of the template.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"name":{"type":"string","title":"Name","description":"The name of the template.","example":"Article Page"}},"type":"object","title":"TemplateModel"}},"schema_1464":{"kind":"json-schema","data":{"description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","title":"X-Sc-Job-Id","example":"job-1234"},"id":"schema_1464"},"schema_1465":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Siteid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the site. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_sites_list"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List sites"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"id":"schema_1465"},"schema_1466":{"kind":"json-schema","data":{"type":"string","title":"Sitename","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique name of the site. To get this name, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_sites_list"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List sites"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"skate-park"},"id":"schema_1466"},"schema_1467":{"kind":"json-schema","data":{"type":"string","default":"en","title":"Language","description":"The language code for filtering pages.","example":"en"},"id":"schema_1467"},"schema_1468":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/PageModel"},"title":"Response Sites-Get All Pages By Site"},"id":"schema_1468"},"schema_1469":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Itemid","description":"The unique identifier of the item. ","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"id":"schema_1469"},"schema_1470":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Pageid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page.To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"f0b81bcc-7388-46be-b109-6e73d1114470"},"id":"schema_1470"},"schema_1471":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Pageid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"f0b81bcc-7388-46be-b109-6e73d1114470"},"id":"schema_1471"},"schema_1472":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Pageid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page from which to retrieve components. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"f0b81bcc-7388-46be-b109-6e73d1114470"},"id":"schema_1472"},"schema_1473":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"en","title":"Language","description":"The language code for filtering components.","example":"en"},"id":"schema_1473"},"schema_1474":{"kind":"json-schema","data":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Version","description":"The version number of the page to retrieve components from.","example":1},"id":"schema_1474"},"schema_1475":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variantid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the  personalization or A/B/n test variant on the page. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://api-docs.sitecore.com/sai/agent-api/flow-definitions/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint. Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transpiledVariants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"variants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when available."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you provide this value, the endpoint returns components of the specified variant. If you omit this value, the endpoint returns components of the base page."},"children":[]}]}]}],"example":"8bd7a9ec96b8490f9b894e3866fefb79_2a5c1e8c8d244f569a44d6b28cbecb05"},"id":"schema_1475"},"schema_1476":{"kind":"json-schema","data":{"type":"boolean","default":true,"title":"Includerenderingdetails","description":"Whether the response includes rendering details for each component."},"id":"schema_1476"},"schema_1477":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Componentid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the component on the page. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/pages-get_components_on_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieve components on a page"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"86a03271-dff4-470a-92bd-b68c67de2e25"},"id":"schema_1477"},"schema_1478":{"kind":"json-schema","data":{"type":"string","title":"Search Query","description":"The search term to look for in page titles and content.","example":"skate"},"id":"schema_1478"},"schema_1479":{"kind":"json-schema","data":{"type":"string","title":"Site Name","description":"The unique name of the site to search within.","example":"skate-park"},"id":"schema_1479"},"schema_1480":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/PageSearchItemModel"},"title":"Response Pages-Search Site"},"id":"schema_1480"},"schema_1481":{"kind":"json-schema","data":{"type":"string","format":"uri","minLength":1,"maxLength":2083,"title":"Live Url","description":"The full public URL of the page to resolve. The URL must be absolute and include the page path.","example":"https://www.sitecore.com/sitecore/content/Verticals/SkatePark/Home"},"id":"schema_1481"},"schema_1482":{"kind":"json-schema","data":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether to search the site's published routes when the standard lookup cannot find the page. Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when a page you know exists is returned as not found, for example when its public URL differs from its item name in Sitecore. This lookup can take significantly longer."},"children":[]}]}]}],"default":false,"title":"Deep"},"id":"schema_1482"},"schema_1483":{"kind":"json-schema","data":{"type":"integer","title":"Version","description":"The version number of the page to retrieve the screenshot for.","example":1},"id":"schema_1483"},"schema_1484":{"kind":"json-schema","data":{"type":"string","default":"en","title":"Language","description":"The language code for the page.","example":"en"},"id":"schema_1484"},"schema_1485":{"kind":"json-schema","data":{"type":"integer","default":1200,"title":"Width","description":"The width of the screenshot in pixels.","example":1200},"id":"schema_1485"},"schema_1486":{"kind":"json-schema","data":{"type":"integer","default":800,"title":"Height","description":"The height of the screenshot in pixels.","example":800},"id":"schema_1486"},"schema_1487":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variantid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the personalization or A/B/n test variant to show in the screenshot. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint. Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transpiledVariants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"variants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when available."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you provide this value, the screenshot is captured for the specified variant. If you omit this value, the screenshot is captured for the base page."},"children":[]}]}]}],"example":"8bd7a9ec96b8490f9b894e3866fefb79_2a5c1e8c8d244f569a44d6b28cbecb05"},"id":"schema_1487"},"schema_1488":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Pageid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"550e8400-e29b-41d4-a716-446655440000"},"id":"schema_1488"},"schema_1489":{"kind":"json-schema","data":{"type":"string","title":"Language","description":"The language code for the page content.","example":"en"},"id":"schema_1489"},"schema_1490":{"kind":"json-schema","data":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Version","description":"The version number of the page to retrieve.","example":1},"id":"schema_1490"},"schema_1491":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variantid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the personalization or A/B/n test variant to use. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint. Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transpiledVariants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"variants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when available."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you provide this value, the HTML content is retrieved for the specified variant. If you omit this value, the HTML content for the base page is returned."},"children":[]}]}]}],"example":"8bd7a9ec96b8490f9b894e3866fefb79_2a5c1e8c8d244f569a44d6b28cbecb05"},"id":"schema_1491"},"schema_1492":{"kind":"json-schema","data":{"type":"string","default":"en","title":"Language","description":"The language code for the page content.","example":"en"},"id":"schema_1492"},"schema_1493":{"kind":"json-schema","data":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Version","description":"The version number of the page to retrieve the preview URL for.","example":1},"id":"schema_1493"},"schema_1494":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variantid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the personalization or A/B/n test variant to preview. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint. Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transpiledVariants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"variants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when available."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you provide this value, the preview URL is retrieved for the specified variant. If you omit this value, the preview URL for the base page is returned."},"children":[]}]}]}],"example":"8bd7a9ec96b8490f9b894e3866fefb79_2a5c1e8c8d244f569a44d6b28cbecb05"},"id":"schema_1494"},"schema_1495":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Templateid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page template. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_templates_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List templates of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint."},"children":[]}]}]}],"example":"2341ef32-42f4-4537-98d8-9ef741008eab"},"id":"schema_1495"},"schema_1496":{"kind":"json-schema","data":{"type":"string","title":"Placeholdername","description":"The unique identifier of the placeholder.","example":"123e4567-e89b-12d3-a456-426614174000"},"id":"schema_1496"},"schema_1497":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variantid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the personalization or A/B/n test variant to use. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint. Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transpiledVariants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"variants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when available."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you provide this value, the list of allowed components is retrieved for the specified variant. If you omit this value, the list for the base page is returned."},"children":[]}]}]}],"example":"8bd7a9ec96b8490f9b894e3866fefb79_2a5c1e8c8d244f569a44d6b28cbecb05"},"id":"schema_1497"},"schema_1498":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/ComponentShortInfo"},"title":"Response Pages-Get Allowed Components By Placeholder"},"id":"schema_1498"},"schema_1499":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Itemid","description":"The unique identifier of the content item to be retrieved.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"id":"schema_1499"},"schema_1500":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"The language version of the content item to be retrieved. If not specified, the default language is used.","example":"en"},"id":"schema_1500"},"schema_1501":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Itemid","description":"The unique identifier of the content item to be updated.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"id":"schema_1501"},"schema_1502":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Itemid","description":"The unique identifier of the content item to be deleted.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"id":"schema_1502"},"schema_1503":{"kind":"json-schema","data":{"type":"string","default":"en","title":"Language","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language version of the content item."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Deleting a content item removes the item across all language versions. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"language"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter does not limit deletion to a specific language version."},"children":[]}]}]}],"example":"en"},"id":"schema_1503"},"schema_1504":{"kind":"json-schema","data":{"type":"string","title":"Item Path","description":"The path of the content item in the content tree.","example":"%2Fsitecore%2Fcontent%2FVerticals%2FSkaterPark%2FHome"},"id":"schema_1504"},"schema_1505":{"kind":"json-schema","data":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":true,"title":"Failonnotfound","description":"Determines the behavior when the content item is not found.","example":"true"},"id":"schema_1505"},"schema_1506":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"en","title":"Language","description":"The language version of the content item to be retrieved.","example":"en"},"id":"schema_1506"},"schema_1507":{"kind":"json-schema","data":{"anyOf":[{"$ref":"#/components/schemas/ContentItemResponse"},{"type":"object","additionalProperties":true}],"title":"Response Content-Get Content Item By Path"},"id":"schema_1507"},"schema_1508":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Itemid","description":"The unique identifier of the parent item under which new items can be inserted.","example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"id":"schema_1508"},"schema_1509":{"kind":"json-schema","data":{"type":"string","default":"en","title":"Language","description":"The language code for filtering insert options.","example":"en"},"id":"schema_1509"},"schema_1510":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/InsertOptionModel"},"title":"Response Content-List Available Insertoptions"},"id":"schema_1510"},"schema_1511":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Componentid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the component for which to create a datasource. To get this ID, use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/pages-get_allowed_components_by_placeholder"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List allowed components for a placeholder"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint."},"children":[]}]}]}],"example":"86a03271-dff4-470a-92bd-b68c67de2e25"},"id":"schema_1511"},"schema_1512":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Componentid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the component for which to search datasources. To get this ID, use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/pages-get_allowed_components_by_placeholder"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List allowed components for a placeholder"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint."},"children":[]}]}]}],"example":"86a03271-dff4-470a-92bd-b68c67de2e25"},"id":"schema_1512"},"schema_1513":{"kind":"json-schema","data":{"type":"string","title":"Term","description":"The search term to filter available datasources.","example":"news"},"id":"schema_1513"},"schema_1514":{"kind":"json-schema","data":{"type":"string","title":"Site Name","description":"The name of the site for which to list available components.","example":"skate-park"},"id":"schema_1514"},"schema_1515":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Componentid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the component. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/pages-get_all_components_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List components of a page"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"86a03271-dff4-470a-92bd-b68c67de2e25"},"id":"schema_1515"},"schema_1516":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query","description":"The search term to filter assets.","example":"summer"},"id":"schema_1516"},"schema_1517":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"en","title":"Language","description":"The language code to filter assets.","example":"en"},"id":"schema_1517"},"schema_1518":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","description":"The file type to filter assets such as image, video, or document.","example":"image"},"id":"schema_1518"},"schema_1519":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/AssetSearchResultModel"},"title":"Response Assets-Search Assets"},"id":"schema_1519"},"schema_1520":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Assetid","description":"The unique identifier of the asset to be retrieved.","example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890"},"id":"schema_1520"},"schema_1521":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Assetid","description":"The unique identifier of the asset to be updated.","example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890"},"id":"schema_1521"},"schema_1522":{"kind":"json-schema","data":{"description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API. ","title":"X-Sc-Job-Id","example":"job-1234"},"id":"schema_1522"},"schema_1523":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/LanguageModel"},"title":"Response Environments-List Languages"},"id":"schema_1523"},"schema_1524":{"kind":"json-schema","data":{"type":"string","title":"Pageid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page for which to create a personalization version. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"id":"schema_1524"},"schema_1525":{"kind":"json-schema","data":{"type":"string","title":"Pageid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page for which to retrieve personalization versions. To get this ID, use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"id":"schema_1525"},"schema_1526":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"en","title":"Language","description":"The language version of the page.","example":"en"},"id":"schema_1526"},"schema_1527":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/PersonalizationVariantDetailModelV2"},"title":"Response Personalization-Get Personalization Versions By Page"},"id":"schema_1527"},"schema_1528":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/ConditionTemplate"},"title":"Response Personalization-Get Condition Templates"},"id":"schema_1528"},"schema_1529":{"kind":"json-schema","data":{"type":"string","title":"Template Id","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the condition template. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/operation/personalization-get_condition_templates"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List personalization condition templates"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of available condition templates."},"children":[]}]}]}],"example":"returning_visitor"},"id":"schema_1529"},"schema_1530":{"kind":"json-schema","data":{"type":"string","title":"Pageid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page for which to update a personalization variant. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of pages for a specific site."},"children":[]}]}]}],"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"id":"schema_1530"},"schema_1531":{"kind":"json-schema","data":{"type":"string","title":"Variantid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the personalization variant to be updated. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/operation/personalization-get_personalization_versions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List personalization variants by page"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint. Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transpiledVariants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"variants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when available."},"children":[]}]}]}],"example":"afbdf7912c774dd997f5c7c9d627708e_7ccdaf587ae54fe4919996192507c383"},"id":"schema_1531"},"schema_1532":{"kind":"json-schema","data":{"type":"string","title":"Pageid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page that includes the default page variant where the component should be hidden. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of pages for a specific site."},"children":[]}]}]}]},"id":"schema_1532"},"schema_1533":{"kind":"json-schema","data":{"type":"string","title":"Componentid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the component to hide on the default page variant. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/pages-get_all_components_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List components of a page"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of components for a specific page."},"children":[]}]}]}]},"id":"schema_1533"},"schema_1534":{"kind":"json-schema","data":{"description":"A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.","title":"X-Sc-Job-Id"},"id":"schema_1534"},"schema_1535":{"kind":"json-schema","data":{"type":"string","title":"Pageid"},"id":"schema_1535"},"schema_1536":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"en","title":"Language"},"id":"schema_1536"},"schema_1537":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/PersonalizationVariantDetailModelV1"},"title":"Response Personalization-Get Personalization Versions By Page V1"},"id":"schema_1537"},"schema_1538":{"kind":"json-schema","data":{"type":"string","title":"Jobid","description":"The unique identifier of the job to be reverted.","example":"job-1234"},"id":"schema_1538"},"schema_1539":{"kind":"json-schema","data":{"title":"Response Jobs-Revert Job"},"id":"schema_1539"},"schema_1540":{"kind":"json-schema","data":{"type":"string","title":"Jobid","description":"The unique identifier of the job to retrieve.","example":"job-1234"},"id":"schema_1540"},"schema_1541":{"kind":"json-schema","data":{"title":"Response Jobs-Get Job"},"id":"schema_1541"},"schema_1542":{"kind":"json-schema","data":{"type":"string","title":"Jobid","description":"The unique identifier of the job for which to list operations.","example":"job-1234"},"id":"schema_1542"},"schema_1543":{"kind":"json-schema","data":{"title":"Response Jobs-List Operations"},"id":"schema_1543"},"schema_1544":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/ListBrandKitResponse"},"title":"Response Brandkits-List Brandkits"},"id":"schema_1544"},"schema_1545":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Brandkitid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the brand kit to retrieve. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/brandkits-list_brandkits"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List brand kits"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of brand kits in your organization."},"children":[]}]}]}],"example":"f2657200-e881-4027-8ddf-a9810eb9d177"},"id":"schema_1545"},"schema_1546":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/ListBrandContextResponse"},"title":"Response Brand-Contexts-List Brand Contexts"},"id":"schema_1546"},"schema_1547":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Brandcontextid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the brand context to retrieve. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/brand-contexts-list_brand_contexts"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List brand contexts"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of brand contexts in your organization."},"children":[]}]}]}],"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"id":"schema_1547"},"schema_1548":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Brandcontextid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the brand context from which to retrieve items. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/brand-contexts-list_brand_contexts"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List brand contexts"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of brand contexts in your organization."},"children":[]}]}]}],"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"id":"schema_1548"},"schema_1549":{"kind":"json-schema","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comma-separated brand context item IDs (UUIDs) of files or folders to fetch, up to 50. To get these IDs, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/brand-contexts-get_brand_context"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieve a brand context by ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the complete nested folder or file tree index of the brand context."},"children":[]}]}]}],"example":["3f2504e0-4f89-11d3-9a0c-0305e82c3301,a1b2c3d4-4f89-11d3-9a0c-0305e82c3301"],"title":"Ids"},"id":"schema_1549"},"schema_1550":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"The name of the brief to filter the list of briefs by. Supports partial matches, for example, if you specify 'summer', it will match briefs with names like 'Summer Campaign Brief' or '2026 Summer Product Launch Brief'.","example":"summer"},"id":"schema_1550"},"schema_1551":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"The status of the brief, such as draft, active, or archived.","example":"active"},"id":"schema_1551"},"schema_1552":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creator Id","description":"The unique identifier of the user who created the brief.","example":"user-1234"},"id":"schema_1552"},"schema_1553":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type Id","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the brief type to filter briefs by. To get the list of brief type IDs, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/list-brief_types"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List brief types"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint."},"children":[]}]}]}],"example":"brieftype-1234"},"id":"schema_1553"},"schema_1554":{"kind":"json-schema","data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sort By","description":"The field by which to sort the list of briefs.","example":"name"},"id":"schema_1554"},"schema_1555":{"kind":"json-schema","data":{"type":"string","title":"Brief Type Id","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the brief type to retrieve. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/list-brief_types"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List brief types"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of brief types available in your organization."},"children":[]}]}]}],"example":"bt-1234"},"id":"schema_1555"},"schema_1556":{"kind":"json-schema","data":{"type":"string","title":"Brief Id","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the brief to retrieve. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/list-briefs"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List briefs"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of briefs in your organization."},"children":[]}]}]}],"example":"brief-1234"},"id":"schema_1556"},"schema_1557":{"kind":"json-schema","data":{"type":"string","title":"Flowid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the A/B/n test to update. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint for the page and use the flow "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value."},"children":[]}]}]}],"example":"1fdfbc60-9646-469d-b971-2b0f4c033fbc"},"id":"schema_1557"},"schema_1558":{"kind":"json-schema","data":{"type":"string","format":"uuid","title":"Pageid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the page for which to retrieve flow definitions (A/B/n tests or personalizations). To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/sites-get_all_pages_by_site"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List pages of a site"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint to retrieve the list of pages for a specific site."},"children":[]}]}]}],"example":"3f2504e0-4f89-11d3-9a0c-0305e82c3301"},"id":"schema_1558"},"schema_1559":{"kind":"json-schema","data":{"type":"string","default":"en","title":"Language","description":"The language version of the page to filter flow definitions (A/B/n tests or personalizations).","example":"en"},"id":"schema_1559"},"schema_1560":{"kind":"json-schema","data":{"type":"string","title":"Status","description":"The status to filter flow definitions (A/B/n tests or personalizations), such as active, paused, or draft.","example":"active"},"id":"schema_1560"},"schema_1561":{"kind":"json-schema","data":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/ExperimentFlowResponse"},{"$ref":"#/components/schemas/ExperienceFlowResponseV2"}],"discriminator":{"propertyName":"subtype","mapping":{"EXPERIMENT":"#/components/schemas/ExperimentFlowResponse","EXPERIENCE":"#/components/schemas/ExperienceFlowResponseV2"}}},"title":"Response Flows-List Flow Definitions By Page"},"id":"schema_1561"},"schema_1562":{"kind":"json-schema","data":{"type":"string","title":"Flowid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the A/B/n test or personalization to retrieve. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint for the page and use the flow "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value."},"children":[]}]}]}],"example":"1fdfbc60-9646-469d-b971-2b0f4c033fbc"},"id":"schema_1562"},"schema_1563":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/ExperimentFlowResponse"},{"$ref":"#/components/schemas/ExperienceFlowResponseV2"}],"discriminator":{"propertyName":"subtype","mapping":{"EXPERIMENT":"#/components/schemas/ExperimentFlowResponse","EXPERIENCE":"#/components/schemas/ExperienceFlowResponseV2"}},"title":"Response Flows-Get Flow Definition"},"id":"schema_1563"},"schema_1564":{"kind":"json-schema","data":{"type":"string","title":"Flowid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the A/B/n test or personalization that contains the variant to reset. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint for the page and use the flow "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value."},"children":[]}]}]}]},"id":"schema_1564"},"schema_1565":{"kind":"json-schema","data":{"type":"string","title":"Flowid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the A/B/n test or personalization to set up. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint for the page and use the flow "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value."},"children":[]}]}]}],"example":"1fdfbc60-9646-469d-b971-2b0f4c033fbc"},"id":"schema_1565"},"schema_1566":{"kind":"json-schema","data":{"type":"string","title":"Variantid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the personalization or A/B/n test variant to set up. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint. Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transpiledVariants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"variants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when available."},"children":[]}]}]}],"example":"8ea2cb6f-a92a-4c05-88a3-a4c0b29c63a8"},"id":"schema_1566"},"schema_1567":{"kind":"json-schema","data":{"type":"string","title":"Flowid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the personalization or A/B/n test to retrieve. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for the page and use the flow "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value."},"children":[]}]}]}],"example":"1fdfbc60-9646-469d-b971-2b0f4c033fbc"},"id":"schema_1567"},"schema_1568":{"kind":"json-schema","data":{"type":"string","title":"Variantid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the personalization or A/B/n test variant to retrieve. To get this ID, you can use the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#/operation/flows-list_flow_definitions_by_page"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List flow definitions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint. Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transpiledVariants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"variants[].ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when available."},"children":[]}]}]}],"example":"8ea2cb6f-a92a-4c05-88a3-a4c0b29c63a8"},"id":"schema_1568"},"schema_1569":{"kind":"json-schema","data":{"type":"string","description":"The language version of the page for which to retrieve the variant details.","default":"en","title":"Language","example":"en"},"id":"schema_1569"},"schema_1570":{"kind":"json-schema","data":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The page version for which to retrieve the variant details. If not specified, the latest version will be used.","title":"Version","example":5},"id":"schema_1570"}},"exampleStore":{},"securitySchemeStore":{"HTTPBearer":{"id":"HTTPBearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}},"servers":[{"url":"https://edge-platform.sitecorecloud.io/stream/ai-agent-api","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/agent-api/@v2.0/index.json?download"},{"url":"/_bundle/sai/agent-api/@v2.0/index.yaml?download"}],"excludeFromSearch":false,"replayFeatures":{"graphql":false},"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Agent API","description":"\nThe Agent API allows AI agents to take direct action in Sitecore through secure REST endpoints. It supports common digital experience tasks such as creating pages, adding components, and updating content.\n\nAs part of Sitecore's [*interoperability*](https://doc.sitecore.com/xmc/en/users/xm-cloud/integrating-sitecore-with-agentic-platforms.html) approach, the Agent API allows agentic platforms and other connected systems to interact directly with Sitecore. When an AI agent receives a natural language request, it can call the appropriate Agent API endpoints to complete the task. For example, a request to create a new landing page might trigger an endpoint in Sitecore that automatically builds the page. If the AI agent performs an unintended action, you can use the job ID to revert it. Each operation is tracked to ensure safe rollback when needed.\n\nAll Agent API actions follow the built-in security and approval rules in Sitecore, keeping work safe, traceable, and auditable.\n\nIn addition to AI agent-driven workflows, developers can also use the REST API directly to interact with the following objects:\n\n- **Sites** - retrieve and manage sites and their pages.\n- **Pages** - create and manage pages and components.\n- **Content** - create and organize content items.\n- **Components** - retrieve and manage components and datasources.\n- **Assets** - upload and manage digital assets.\n- **Environments** - retrieve environment and language details.\n- **Personalization** - manage personalized content variants.\n- **Jobs** - view or revert job operations. \n- **Brand kits** - retrieve brand kits and their details.\n- **Brand contexts** - retrieve brand contexts, their metadata, folder and file trees, and content. \n- **Briefs** - retrieve brief types, generate and create briefs.\n- **Experiments** - create and update A/B tests on components on a page.\n- **Flow definitions** - retrieve flow definitions (A/B/n tests and personalizations) for a page and set up their variants.\n\n\nNote the following:\n\n- To use this REST API, you authenticate your API requests.\n- All API requests are made in your production environment.\n\nThe Agent API also powers the Sitecore Marketer MCP server, which uses these endpoints to perform agentic operations in Sitecore. Read more about the [Marketer MCP server](https://doc.sitecore.com/sai/en/users/sitecoreai/sitecore-marketer-mcp-server.html).\n\n# Authorization\n To authorize your requests, use environment automation client credentials and generate a JSON Web Token (JWT). You can also register an OAuth app if your integration requires the OAuth 2.0 authorization code flow.\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## Register an OAuth app for the Agent API \nThe Agent API uses the OAuth 2.0 authorization code flow to securely authenticate requests from external applications.\n\n Each application must have an OAuth app registration, which identifies the app and defines the parts of the Sitecore platform it can access. \n\n If you plan to register an OAuth app that uses the Agent API, you must submit a registration request to Sitecore Support and request the following scopes:\n - `xmcloud.cm:admin` \n - `personalize.exp:mng` \n - `personalize.tmpl:r` \n - `personalize.pos:mng` \n - `ai.org.bri:r` \n - `co.briefs:r` \n - `co.briefs:w`  \n- `ai.org.brd:r` \n- `ai.org.bri:w`  \n- `cmp.sites:read` \n- `platform.tenants:list` \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\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```\n","product":"SitecoreAI"}},"baseSlug":"/sai/agent-api","routesMapping":{}}