{"items":[{"type":"link","label":"Cache API","link":"/sai/cache-api","routeSlug":"/sai/cache-api","content":{"contentType":"overview","meta":{"name":"Cache API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"index.json","url":"/_bundle/sai/cache-api/index.json?download"},{"kind":"download","label":"index.yaml","url":"/_bundle/sai/cache-api/index.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[{"kind":"externallink","title":"License","titleTranslationKey":"info.license","label":"closed source","url":"https://www.sitecore.com"}]},{"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://cs-graphqlapi-prod.sitecorecloud.io"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Cache API (2.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":"Use the XM Cloud Content Cache API to clear parts of the cache for GraphQL requests. This REST API lets you clean up a cache for a specific tenant. It is rate limited to 10 requests per second per tenant."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"admonition","inline":true,"attributes":{"type":"warning","name":"Warning"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Clearing the cache can have a negative effect on the performance of the tenant application because all GraphQL requests must be executed fully. We recommend that you do not clear the caches or call this API as part of a build process."},"children":[]}]}]}]}]}],"sectionId":"/sai/cache-api"}],"sectionId":"/sai/cache-api"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"section/authentication"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To use this API, you need:"},"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":"The URL of your XM Cloud Content server. You can get this from your XM Cloud Administer."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A JWT bearer token requested using the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/xmc/en/developers/xm-cloud/request-a-jwt-for-experience-edge.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth Client Credentials flow"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". It is sent with every request. The token must include the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cs:all:admin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" scope."},"children":[]}]}]}]}]}],"sectionId":"/sai/cache-api/section/authentication"}]}]}},{"type":"link","label":"Authentication","link":"/sai/cache-api/section/authentication","routeSlug":"/sai/cache-api/section/authentication","content":null},{"type":"group","label":"Cache","link":"/sai/cache-api/cache","routeSlug":"/sai/cache-api/cache","items":[{"label":"Clear the cache for a specific branch","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/cache-api/cache/clearall","routeSlug":"/sai/cache-api/cache/clearall","metadata":{"seo":{"title":"Clear the cache for a specific branch","description":"Clears the cache for a specific branch."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ClearAll","name":"Clear the cache for a specific branch","isWebhook":false,"pointer":"/paths/~1api~1v2~1cache~1{branch}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Clear the cache for a specific branch","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Clears the cache for a specific branch.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"Bearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A JSON Web Token (JWT) is sent with every call. To obtain one, you need an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/xmc/en/developers/xm-cloud/generate-an-edge-token.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"access token and the client"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can create a token "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/xmc/en/developers/xm-cloud/request-a-jwt-for-experience-edge.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"using the Deploy REST API or by requesting one"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"to the API"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"itself"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"branch","in":"path","schemaId":"schema_1315","description":"The name of the branch to clear.","required":true}],"pointer":"/paths/~1api~1v2~1cache~1{branch}/delete/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"api-version","in":"query","schemaId":"schema_1315"}],"pointer":"/paths/~1api~1v2~1cache~1{branch}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/cache/{branch}","servers":[{"url":"https://cs-graphqlapi-prod.sitecorecloud.io"}],"parameters":{"path":[{"name":"branch","in":"path","required":true,"schemaId":"schema_1315"}],"query":[{"name":"api-version","in":"query","schemaId":"schema_1315"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["204","400","401","403","404"],"pointer":"/api/v2/cache/{branch}","href":"cache/clearall","openApiOperationId":"ClearAll","summary":"Clear the cache for a specific branch"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://cs-graphqlapi-prod.sitecorecloud.io"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"The cache was successfully cleared"},{"code":"400","description":"Invalid input, such as missing the branch name in the URL","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HttpValidationProblemDetails"}},"schemaId":"components/schemas/HttpValidationProblemDetails"},{"code":"401","description":"Invalid bearer token"},{"code":"403","description":"Insufficient scopes in bearer token"},{"code":"404","description":"The branch was not found"}],"pointer":"/paths/~1api~1v2~1cache~1{branch}/delete/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"204"},{"code":"400","schemaId":"components/schemas/HttpValidationProblemDetails","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HttpValidationProblemDetails"}}},{"code":"401"},{"code":"403"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cache/clearall"}],"panels":[]}]},"httpPath":"/api/v2/cache/{branch}"},{"label":"Clear cache query responses for a specific content type","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/cache-api/cache/clearbycontenttype","routeSlug":"/sai/cache-api/cache/clearbycontenttype","metadata":{"seo":{"title":"Clear cache query responses for a specific content type","description":"Clears the cache of query responses that use a particular content type."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ClearByContentType","name":"Clear cache query responses for a specific content type","isWebhook":false,"pointer":"/paths/~1api~1v2~1cache~1{branch}~1contenttype~1{contentType}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Clear cache query responses for a specific content type","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Clears the cache of query responses that use a particular content type.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"Bearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A JSON Web Token (JWT) is sent with every call. To obtain one, you need an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/xmc/en/developers/xm-cloud/generate-an-edge-token.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"access token and the client"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can create a token "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/xmc/en/developers/xm-cloud/request-a-jwt-for-experience-edge.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"using the Deploy REST API or by requesting one"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"to the API"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"itself"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"branch","in":"path","schemaId":"schema_1315","description":"The name of the branch to clear.","required":true},{"name":"contentType","in":"path","schemaId":"schema_1315","description":"The ID of the content type to clear.","required":true}],"pointer":"/paths/~1api~1v2~1cache~1{branch}~1contenttype~1{contentType}/delete/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"api-version","in":"query","schemaId":"schema_1315"}],"pointer":"/paths/~1api~1v2~1cache~1{branch}~1contenttype~1{contentType}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/cache/{branch}/contenttype/{contentType}","servers":[{"url":"https://cs-graphqlapi-prod.sitecorecloud.io"}],"parameters":{"path":[{"name":"branch","in":"path","required":true,"schemaId":"schema_1315"},{"name":"contentType","in":"path","required":true,"schemaId":"schema_1315"}],"query":[{"name":"api-version","in":"query","schemaId":"schema_1315"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["204","400","401","403","404"],"pointer":"/api/v2/cache/{branch}/contenttype/{contentType}","href":"cache/clearbycontenttype","openApiOperationId":"ClearByContentType","summary":"Clear cache query responses for a specific content type"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://cs-graphqlapi-prod.sitecorecloud.io"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"The cache was successfully cleared"},{"code":"400","description":"Invalid input, such as missing the branch name in the URL","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HttpValidationProblemDetails"}},"schemaId":"components/schemas/HttpValidationProblemDetails"},{"code":"401","description":"Invalid bearer token"},{"code":"403","description":"Request does not contain required scopes"},{"code":"404","description":"The branch or content type was not found."}],"pointer":"/paths/~1api~1v2~1cache~1{branch}~1contenttype~1{contentType}/delete/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"204"},{"code":"400","schemaId":"components/schemas/HttpValidationProblemDetails","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HttpValidationProblemDetails"}}},{"code":"401"},{"code":"403"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cache/clearbycontenttype"}],"panels":[]}]},"httpPath":"/api/v2/cache/{branch}/contenttype/{contentType}"},{"label":"Clear cache query responses for a specific locale","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/cache-api/cache/clearbylocale","routeSlug":"/sai/cache-api/cache/clearbylocale","metadata":{"seo":{"title":"Clear cache query responses for a specific locale","description":"Clears the cache of query responses that use a particular locale."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ClearByLocale","name":"Clear cache query responses for a specific locale","isWebhook":false,"pointer":"/paths/~1api~1v2~1cache~1{branch}~1locale~1{locale}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Clear cache query responses for a specific locale","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Clears the cache of query responses that use a particular locale.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"Bearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A JSON Web Token (JWT) is sent with every call. To obtain one, you need an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/xmc/en/developers/xm-cloud/generate-an-edge-token.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"access token and the client"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can create a token "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/xmc/en/developers/xm-cloud/request-a-jwt-for-experience-edge.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"using the Deploy REST API or by requesting one"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"to the API"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"itself"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"branch","in":"path","schemaId":"schema_1315","description":"The name of the branch to clear.","required":true},{"name":"locale","in":"path","schemaId":"schema_1315","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The culture code, for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"en-US"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", for which to clear queries."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1api~1v2~1cache~1{branch}~1locale~1{locale}/delete/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"api-version","in":"query","schemaId":"schema_1315"}],"pointer":"/paths/~1api~1v2~1cache~1{branch}~1locale~1{locale}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/cache/{branch}/locale/{locale}","servers":[{"url":"https://cs-graphqlapi-prod.sitecorecloud.io"}],"parameters":{"path":[{"name":"branch","in":"path","required":true,"schemaId":"schema_1315"},{"name":"locale","in":"path","required":true,"schemaId":"schema_1315"}],"query":[{"name":"api-version","in":"query","schemaId":"schema_1315"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["204","400","401","403","404"],"pointer":"/api/v2/cache/{branch}/locale/{locale}","href":"cache/clearbylocale","openApiOperationId":"ClearByLocale","summary":"Clear cache query responses for a specific locale"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://cs-graphqlapi-prod.sitecorecloud.io"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"The cache was successfully cleared"},{"code":"400","description":"Invalid input, such as missing the branch name in the URL","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HttpValidationProblemDetails"}},"schemaId":"components/schemas/HttpValidationProblemDetails"},{"code":"401","description":"Invalid bearer token"},{"code":"403","description":"Request does not contain required scopes"},{"code":"404","description":"The branch or content type was not found"}],"pointer":"/paths/~1api~1v2~1cache~1{branch}~1locale~1{locale}/delete/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"204"},{"code":"400","schemaId":"components/schemas/HttpValidationProblemDetails","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HttpValidationProblemDetails"}}},{"code":"401"},{"code":"403"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cache/clearbylocale"}],"panels":[]}]},"httpPath":"/api/v2/cache/{branch}/locale/{locale}"},{"label":"Clear cache query responses for a specific content type and locale","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/cache-api/cache/clearbycontenttypeandlocale","routeSlug":"/sai/cache-api/cache/clearbycontenttypeandlocale","metadata":{"seo":{"title":"Clear cache query responses for a specific content type and locale","description":"Clears the cache of query responses that use a particular content type and locale."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ClearByContentTypeAndLocale","name":"Clear cache query responses for a specific content type and locale","isWebhook":false,"pointer":"/paths/~1api~1v2~1cache~1{branch}~1contenttype~1{contentType}~1locale~1{locale}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Clear cache query responses for a specific content type and locale","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Clears the cache of query responses that use a particular content type and locale.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"Bearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A JSON Web Token (JWT) is sent with every call. To obtain one, you need an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/xmc/en/developers/xm-cloud/generate-an-edge-token.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"access token and the client"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can create a token "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/xmc/en/developers/xm-cloud/request-a-jwt-for-experience-edge.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"using the Deploy REST API or by requesting one"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"to the API"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"itself"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"branch","in":"path","schemaId":"schema_1315","description":"The name of the branch to clear.","required":true},{"name":"contentType","in":"path","schemaId":"schema_1315","description":"The ID of the content type to clear.","required":true},{"name":"locale","in":"path","schemaId":"schema_1315","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The culture code, for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"en-US"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", for which to clear queries."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1api~1v2~1cache~1{branch}~1contenttype~1{contentType}~1locale~1{locale}/delete/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"api-version","in":"query","schemaId":"schema_1315"}],"pointer":"/paths/~1api~1v2~1cache~1{branch}~1contenttype~1{contentType}~1locale~1{locale}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/cache/{branch}/contenttype/{contentType}/locale/{locale}","servers":[{"url":"https://cs-graphqlapi-prod.sitecorecloud.io"}],"parameters":{"path":[{"name":"branch","in":"path","required":true,"schemaId":"schema_1315"},{"name":"contentType","in":"path","required":true,"schemaId":"schema_1315"},{"name":"locale","in":"path","required":true,"schemaId":"schema_1315"}],"query":[{"name":"api-version","in":"query","schemaId":"schema_1315"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["204","400","401","403","404"],"pointer":"/api/v2/cache/{branch}/contenttype/{contentType}/locale/{locale}","href":"cache/clearbycontenttypeandlocale","openApiOperationId":"ClearByContentTypeAndLocale","summary":"Clear cache query responses for a specific content type and locale"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://cs-graphqlapi-prod.sitecorecloud.io"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"The cache was successfully cleared"},{"code":"400","description":"Invalid input, such as the branch name missing in the URL","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HttpValidationProblemDetails"}},"schemaId":"components/schemas/HttpValidationProblemDetails"},{"code":"401","description":"Invalid bearer token"},{"code":"403","description":"Request does not contain required scopes"},{"code":"404","description":"The branch or content type was not found"}],"pointer":"/paths/~1api~1v2~1cache~1{branch}~1contenttype~1{contentType}~1locale~1{locale}/delete/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"204"},{"code":"400","schemaId":"components/schemas/HttpValidationProblemDetails","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HttpValidationProblemDetails"}}},{"code":"401"},{"code":"403"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cache/clearbycontenttypeandlocale"}],"panels":[]}]},"httpPath":"/api/v2/cache/{branch}/contenttype/{contentType}/locale/{locale}"},{"label":"Clear cache query responses that use other types of data","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sai/cache-api/cache/clearothers","routeSlug":"/sai/cache-api/cache/clearothers","metadata":{"seo":{"title":"Clear cache query responses that use other types of data","description":"Clears the cache of query responses that use other types of data (not related to content types), such as taxonomies."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"ClearOthers","name":"Clear cache query responses that use other types of data","isWebhook":false,"pointer":"/paths/~1api~1v2~1cache~1{branch}~1other/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Clear cache query responses that use other types of data","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Clears the cache of query responses that use other types of data (not related to content types), such as taxonomies.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"Bearer","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A JSON Web Token (JWT) is sent with every call. To obtain one, you need an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/xmc/en/developers/xm-cloud/generate-an-edge-token.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"access token and the client"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can create a token "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/xmc/en/developers/xm-cloud/request-a-jwt-for-experience-edge.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"using the Deploy REST API or by requesting one"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"to the API"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"itself"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"branch","in":"path","schemaId":"schema_1315","description":"The name of the branch to clear.","required":true}],"pointer":"/paths/~1api~1v2~1cache~1{branch}~1other/delete/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"api-version","in":"query","schemaId":"schema_1315"}],"pointer":"/paths/~1api~1v2~1cache~1{branch}~1other/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v2/cache/{branch}/other","servers":[{"url":"https://cs-graphqlapi-prod.sitecorecloud.io"}],"parameters":{"path":[{"name":"branch","in":"path","required":true,"schemaId":"schema_1315"}],"query":[{"name":"api-version","in":"query","schemaId":"schema_1315"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"Bearer","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["204","400","401","403","404"],"pointer":"/api/v2/cache/{branch}/other","href":"cache/clearothers","openApiOperationId":"ClearOthers","summary":"Clear cache query responses that use other types of data"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://cs-graphqlapi-prod.sitecorecloud.io"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"The cache was successfully cleared"},{"code":"400","description":"Invalid input, such as missing the branch name in the URL","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HttpValidationProblemDetails"}},"schemaId":"components/schemas/HttpValidationProblemDetails"},{"code":"401","description":"Invalid bearer token"},{"code":"403","description":"Insufficient scopes in bearer token"},{"code":"404","description":"The branch or content type was not found"}],"pointer":"/paths/~1api~1v2~1cache~1{branch}~1other/delete/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"204"},{"code":"400","schemaId":"components/schemas/HttpValidationProblemDetails","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/HttpValidationProblemDetails"}}},{"code":"401"},{"code":"403"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cache/clearothers"}],"panels":[]}]},"httpPath":"/api/v2/cache/{branch}/other"}],"content":{"contentType":"group","meta":{"name":"Cache"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cache","showPageActions":true},{"nodeType":"markdoc","content":"Caching improves performance. Periodically, however, you need to clear parts of the cache for GraphQL requests."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v2/cache/{branch}","summary":"Clear the cache for a specific branch","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/cache/clearall","deprecated":false},{"title":"/api/v2/cache/{branch}/contenttype/{contentType}","summary":"Clear cache query responses for a specific content type","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/cache/clearbycontenttype","deprecated":false},{"title":"/api/v2/cache/{branch}/locale/{locale}","summary":"Clear cache query responses for a specific locale","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/cache/clearbylocale","deprecated":false},{"title":"/api/v2/cache/{branch}/contenttype/{contentType}/locale/{locale}","summary":"Clear cache query responses for a specific content type and locale","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/cache/clearbycontenttypeandlocale","deprecated":false},{"title":"/api/v2/cache/{branch}/other","summary":"Clear cache query responses that use other types of data","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/cache/clearothers","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/HttpValidationProblemDetails":{"id":"components/schemas/HttpValidationProblemDetails","kind":"json-schema","title":"HttpValidationProblemDetails","data":{"type":"object","properties":{"type":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"status":{"type":"integer","format":"int32","nullable":true},"detail":{"type":"string","nullable":true},"instance":{"type":"string","nullable":true},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}},"additionalProperties":{}}},"schema_1315":{"kind":"json-schema","data":{"type":"string"},"id":"schema_1315"}},"exampleStore":{},"securitySchemeStore":{"Bearer":{"id":"Bearer","type":"http","scheme":"bearer","bearerFormat":"JWT","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A JSON Web Token (JWT) is sent with every call. To obtain one, you need an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/xmc/en/developers/xm-cloud/generate-an-edge-token.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"access token and the client"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can create a token "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/xmc/en/developers/xm-cloud/request-a-jwt-for-experience-edge.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"using the Deploy REST API or by requesting one"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"to the API"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"itself"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}},"servers":[{"url":"https://cs-graphqlapi-prod.sitecorecloud.io"}],"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/cache-api/index.json?download"},{"url":"/_bundle/sai/cache-api/index.yaml?download"}],"excludeFromSearch":false,"replayFeatures":{"graphql":false},"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Cache API","description":"Use the XM Cloud Content Cache API to clear parts of the cache for GraphQL requests. This REST API lets you clean up a cache for a specific tenant. It is rate limited to 10 requests per second per tenant.\n{% admonition type=\"warning\" name=\"Warning\" %}Clearing the cache can have a negative effect on the performance of the tenant application because all GraphQL requests must be executed fully. We recommend that you do not clear the caches or call this API as part of a build process.{% /admonition %}\n## Authentication\nTo use this API, you need:\n - The URL of your XM Cloud Content server. You can get this from your XM Cloud Administer.\n - A JWT bearer token requested using the [OAuth Client Credentials flow](https://doc.sitecore.com/xmc/en/developers/xm-cloud/request-a-jwt-for-experience-edge.html). It is sent with every request. The token must include the `cs:all:admin` scope.\n","product":"SitecoreAI Content"}},"baseSlug":"/sai/cache-api","routesMapping":{}}