{"items":[{"type":"link","label":"Edge Platform Admin API","link":"/portal/edge-platform-admin-rest-api","routeSlug":"/portal/edge-platform-admin-rest-api","content":{"contentType":"overview","meta":{"name":"Edge Platform Admin API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"index.json","url":"/_bundle/portal/edge-platform-admin-rest-api/index.json?download"},{"kind":"download","label":"index.yaml","url":"/_bundle/portal/edge-platform-admin-rest-api/index.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[{"kind":"externallink","title":"License","titleTranslationKey":"info.license","label":"Apache 2.0","url":"https://www.apache.org/licenses/LICENSE-2.0"}]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://edge-platform-admin-api.sitecorecloud.io","description":"Production server"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Edge Platform Admin API (1.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 Edge Platform Admin API to create, retrieve, update, and delete custom hostnames in your organization."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This REST API lets you interact with:"},"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 custom hostname object. Use a "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/custom-hostnames.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"custom hostname"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to serve content or direct traffic to specific web services or applications under your organization's domain."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"After creating a custom hostname, you must:"},"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":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/set-up-a-custom-hostname.html#add-the-cname-and-txt-records-to-your-domains-dns-record"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Register the hostname"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Add the CNAME and TXT records to verify domain ownership."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/set-up-a-custom-hostname.html#check-the-status-of-your-custom-hostname"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Check the status"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Ensure that it is active before using the hostname."},"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":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You must have an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/roles.html#organization-roles"},"children":[{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Organization Admin"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Organization Owner"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" role"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in Sitecore Cloud Portal."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To use this REST API, you must authenticate your API requests."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"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":"For more information, see the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/introduction-to-the-sitecore-cloud-portal.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"official Sitecore Portal developer documentation"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"sectionId":"/portal/edge-platform-admin-rest-api"}],"sectionId":"/portal/edge-platform-admin-rest-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":"The Edge Platform Admin API uses bearer authentication."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bearer authentication involves security tokens called bearer tokens, which are generated in response to a login request."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To get the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/manage-api-tokens.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"bearer token"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Log in to "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://portal.sitecorecloud.io/"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sitecore Cloud Portal"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"In the top-right corner of the menu bar, click your profile "},"children":[]},{"$$mdtype":"Node","type":"image","inline":true,"attributes":{"alt":"profile","src":"https://resources.doc.sitecore.com/assets/image/uuid-b9b63de7-4dd2-ed95-8901-29afe1d1bf30.PNG"},"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":"API tokens"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Click "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Copy to clipboard"},"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":"text","inline":true,"attributes":{"content":"You can now start making REST API requests. You must include this token in the authorization header of every request you make."},"children":[]}]}]}]}],"sectionId":"/portal/edge-platform-admin-rest-api/section/authentication"}]}]}},{"type":"link","label":"Authentication","link":"/portal/edge-platform-admin-rest-api/section/authentication","routeSlug":"/portal/edge-platform-admin-rest-api/section/authentication","content":null},{"type":"group","label":"Organizations","link":"/portal/edge-platform-admin-rest-api/organizations","routeSlug":"/portal/edge-platform-admin-rest-api/organizations","items":[{"label":"Create a custom hostname","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/portal/edge-platform-admin-rest-api/organizations/post_em","routeSlug":"/portal/edge-platform-admin-rest-api/organizations/post_em","metadata":{"seo":{"title":"Create a custom hostname","description":"Creates a custom hostname in your organization by specifying a hostname, a defaultSiteId, and a defaultContextId. Wildcards and apex domains are not currently supported for naming hostnames."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"post_em","name":"Create a custom hostname","isWebhook":false,"pointer":"/paths/~1api~1admin~1v1~1hostnames/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a custom hostname","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 custom hostname in your organization by specifying a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"hostname"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"defaultSiteId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"defaultContextId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Wildcards and apex domains are not currently supported for naming hostnames."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of custom hostnames you can create is limited by your organization's XM Cloud account entitlement. If this limit is exceeded, an error message is returned, and the custom hostname won't be created."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"After it is created, the custom hostname details are stored and used to "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/resolving-a-custom-hostname-during-a-request.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"resolve and route traffic"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for incoming requests."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_1264"}},"schemaId":"schema_1264","pointer":"/paths/~1api~1admin~1v1~1hostnames/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/admin/v1/hostnames","servers":[{"url":"https://edge-platform-admin-api.sitecorecloud.io","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_1264"}},"responseCodes":["202","400","401","403","409","422","500"],"pointer":"/api/admin/v1/hostnames","href":"organizations/post_em","openApiOperationId":"post_em","summary":"Create a custom hostname"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform-admin-api.sitecorecloud.io","description":"Production server"}],"schemaId":"schema_1264","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_1264"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Accepted","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1265"}},"schemaId":"schema_1265"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1266"}},"schemaId":"schema_1266"},{"code":"401","description":"Unauthorized request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1267"}},"schemaId":"schema_1267"},{"code":"403","description":"Forbidden request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1268"}},"schemaId":"schema_1268"},{"code":"409","description":"Conflict","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1269"}},"schemaId":"schema_1269"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1270"}},"schemaId":"schema_1270"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1271"}},"schemaId":"schema_1271"}],"pointer":"/paths/~1api~1admin~1v1~1hostnames/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"202","schemaId":"schema_1265","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1265"}}},{"code":"400","schemaId":"schema_1266","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1266"}}},{"code":"401","schemaId":"schema_1267","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1267"}}},{"code":"403","schemaId":"schema_1268","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1268"}}},{"code":"409","schemaId":"schema_1269","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1269"}}},{"code":"422","schemaId":"schema_1270","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1270"}}},{"code":"500","schemaId":"schema_1271","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1271"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/organizations/post_em"}],"panels":[]}]},"httpPath":"/api/admin/v1/hostnames"},{"label":"List custom hostnames","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/portal/edge-platform-admin-rest-api/organizations/get_sm","routeSlug":"/portal/edge-platform-admin-rest-api/organizations/get_sm","metadata":{"seo":{"title":"List custom hostnames","description":"Retrieves the list of all custom hostnames in your organization. This lets you check if a certain hostname already exists."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get_sm","name":"List custom hostnames","isWebhook":false,"pointer":"/paths/~1api~1admin~1v1~1hostnames/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List custom hostnames","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 all custom hostnames in your organization. This lets you check if a certain hostname already exists.\n\nIf the hostname exists and you need to retrieve, update, or delete it, you can use the appropriate endpoint to perform the desired action."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/admin/v1/hostnames","servers":[{"url":"https://edge-platform-admin-api.sitecorecloud.io","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","401","403","404","500"],"pointer":"/api/admin/v1/hostnames","href":"organizations/get_sm","openApiOperationId":"get_sm","summary":"List custom hostnames"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform-admin-api.sitecorecloud.io","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1265"}},"schemaId":"schema_1265"},{"code":"401","description":"Unauthorized request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1267"}},"schemaId":"schema_1267"},{"code":"403","description":"Forbidden request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1268"}},"schemaId":"schema_1268"},{"code":"404","description":"Resource not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1272"}},"schemaId":"schema_1272"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1271"}},"schemaId":"schema_1271"}],"pointer":"/paths/~1api~1admin~1v1~1hostnames/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1265","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1265"}}},{"code":"401","schemaId":"schema_1267","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1267"}}},{"code":"403","schemaId":"schema_1268","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1268"}}},{"code":"404","schemaId":"schema_1272","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1272"}}},{"code":"500","schemaId":"schema_1271","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1271"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/organizations/get_sm"}],"panels":[]}]},"httpPath":"/api/admin/v1/hostnames"},{"label":"Retrieve a custom hostname","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/portal/edge-platform-admin-rest-api/organizations/get_im","routeSlug":"/portal/edge-platform-admin-rest-api/organizations/get_im","metadata":{"seo":{"title":"Retrieve a custom hostname","description":"Retrieves a specific custom hostname in your organization, including details such as defaultSiteId, defaultContextId, and SSL certificate information."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get_im","name":"Retrieve a custom hostname","isWebhook":false,"pointer":"/paths/~1api~1admin~1v1~1hostnames~1{hostname}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a custom hostname","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieves a specific custom hostname in your organization, including details such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"defaultSiteId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"defaultContextId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and SSL certificate information."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you don't know the exact "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"hostname"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", first retrieve all custom hostnames within your organization using the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://api-docs.sitecore.com/edge-platform-admin-rest-api/organizations/get_sm"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List custom hostnames"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"hostname","in":"path","schemaId":"schema_1273","description":"The specific custom hostname you want to interact with.","required":true}],"pointer":"/paths/~1api~1admin~1v1~1hostnames~1{hostname}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/admin/v1/hostnames/{hostname}","servers":[{"url":"https://edge-platform-admin-api.sitecorecloud.io","description":"Production server"}],"parameters":{"path":[{"name":"hostname","in":"path","required":true,"example":"sitecore-api-preview.example.com","schemaId":"schema_1273"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","401","403","404","500"],"pointer":"/api/admin/v1/hostnames/{hostname}","href":"organizations/get_im","openApiOperationId":"get_im","summary":"Retrieve a custom hostname"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform-admin-api.sitecorecloud.io","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1265"}},"schemaId":"schema_1265"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1274"}},"schemaId":"schema_1274"},{"code":"401","description":"Unauthorized request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1275"}},"schemaId":"schema_1275"},{"code":"403","description":"Forbidden request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1276"}},"schemaId":"schema_1276"},{"code":"404","description":"Resource not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1277"}},"schemaId":"schema_1277"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1278"}},"schemaId":"schema_1278"}],"pointer":"/paths/~1api~1admin~1v1~1hostnames~1{hostname}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1265","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1265"}}},{"code":"400","schemaId":"schema_1274","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1274"}}},{"code":"401","schemaId":"schema_1275","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1275"}}},{"code":"403","schemaId":"schema_1276","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1276"}}},{"code":"404","schemaId":"schema_1277","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1277"}}},{"code":"500","schemaId":"schema_1278","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1278"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/organizations/get_im"}],"panels":[]}]},"httpPath":"/api/admin/v1/hostnames/{hostname}"},{"label":"Update a custom hostname","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/portal/edge-platform-admin-rest-api/organizations/patch_am","routeSlug":"/portal/edge-platform-admin-rest-api/organizations/patch_am","metadata":{"seo":{"title":"Update a custom hostname","description":"Partially updates a custom hostname by replacing the defaultSiteId, defaultContextId, or both, as needed."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"patch_am","name":"Update a custom hostname","isWebhook":false,"pointer":"/paths/~1api~1admin~1v1~1hostnames~1{hostname}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a custom hostname","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":"Partially updates a custom hostname by replacing the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"defaultSiteId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"defaultContextId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or both, as needed."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"hostname"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" itself cannot be updated after the custom hostname has been created and registered. As a workaround, you must delete the existing custom hostname and create a new one to change the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"hostname"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"hostname","in":"path","schemaId":"schema_1273","description":"The specific custom hostname you want to interact with.","required":true}],"pointer":"/paths/~1api~1admin~1v1~1hostnames~1{hostname}/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_1279"}},"schemaId":"schema_1279","pointer":"/paths/~1api~1admin~1v1~1hostnames~1{hostname}/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/api/admin/v1/hostnames/{hostname}","servers":[{"url":"https://edge-platform-admin-api.sitecorecloud.io","description":"Production server"}],"parameters":{"path":[{"name":"hostname","in":"path","required":true,"example":"sitecore-api-preview.example.com","schemaId":"schema_1273"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_1279"}},"responseCodes":["202","400","401","403","404","500"],"pointer":"/api/admin/v1/hostnames/{hostname}","href":"organizations/patch_am","openApiOperationId":"patch_am","summary":"Update a custom hostname"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform-admin-api.sitecorecloud.io","description":"Production server"}],"schemaId":"schema_1279","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_1279"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Accepted","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1279"}},"schemaId":"schema_1279"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1274"}},"schemaId":"schema_1274"},{"code":"401","description":"Unauthorized request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1275"}},"schemaId":"schema_1275"},{"code":"403","description":"Forbidden request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1276"}},"schemaId":"schema_1276"},{"code":"404","description":"Resource not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1277"}},"schemaId":"schema_1277"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1278"}},"schemaId":"schema_1278"}],"pointer":"/paths/~1api~1admin~1v1~1hostnames~1{hostname}/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"202","schemaId":"schema_1279","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1279"}}},{"code":"400","schemaId":"schema_1274","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1274"}}},{"code":"401","schemaId":"schema_1275","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1275"}}},{"code":"403","schemaId":"schema_1276","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1276"}}},{"code":"404","schemaId":"schema_1277","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1277"}}},{"code":"500","schemaId":"schema_1278","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1278"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/organizations/patch_am"}],"panels":[]}]},"httpPath":"/api/admin/v1/hostnames/{hostname}"},{"label":"Delete a custom hostname","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/portal/edge-platform-admin-rest-api/organizations/delete_rm","routeSlug":"/portal/edge-platform-admin-rest-api/organizations/delete_rm","metadata":{"seo":{"title":"Delete a custom hostname","description":"Deletes a custom hostname and all its associated details. This is an irreversible operation."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"delete_rm","name":"Delete a custom hostname","isWebhook":false,"pointer":"/paths/~1api~1admin~1v1~1hostnames~1{hostname}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a custom hostname","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Deletes a custom hostname and all its associated details. This is an irreversible operation."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"hostname","in":"path","schemaId":"schema_1273","description":"The specific custom hostname you want to interact with.","required":true}],"pointer":"/paths/~1api~1admin~1v1~1hostnames~1{hostname}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/admin/v1/hostnames/{hostname}","servers":[{"url":"https://edge-platform-admin-api.sitecorecloud.io","description":"Production server"}],"parameters":{"path":[{"name":"hostname","in":"path","required":true,"example":"sitecore-api-preview.example.com","schemaId":"schema_1273"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["204","400","401","403","404","422","500"],"pointer":"/api/admin/v1/hostnames/{hostname}","href":"organizations/delete_rm","openApiOperationId":"delete_rm","summary":"Delete a custom hostname"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://edge-platform-admin-api.sitecorecloud.io","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No Content"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1274"}},"schemaId":"schema_1274"},{"code":"401","description":"Unauthorized request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1275"}},"schemaId":"schema_1275"},{"code":"403","description":"Forbidden request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1276"}},"schemaId":"schema_1276"},{"code":"404","description":"Resource not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1277"}},"schemaId":"schema_1277"},{"code":"422","description":"Unprocessable entity","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1280"}},"schemaId":"schema_1280"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1278"}},"schemaId":"schema_1278"}],"pointer":"/paths/~1api~1admin~1v1~1hostnames~1{hostname}/delete/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"204"},{"code":"400","schemaId":"schema_1274","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1274"}}},{"code":"401","schemaId":"schema_1275","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1275"}}},{"code":"403","schemaId":"schema_1276","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1276"}}},{"code":"404","schemaId":"schema_1277","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1277"}}},{"code":"422","schemaId":"schema_1280","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1280"}}},{"code":"500","schemaId":"schema_1278","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1278"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/organizations/delete_rm"}],"panels":[]}]},"httpPath":"/api/admin/v1/hostnames/{hostname}"}],"content":{"contentType":"group","meta":{"name":"Organizations"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Organizations","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Organizations API lets you create and manage "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/custom-hostnames.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"custom hostnames"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in your organization."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/admin/v1/hostnames","summary":"Create a custom hostname","prefix":{"name":"post","color":"post"},"badges":[],"link":"/organizations/post_em","deprecated":false},{"title":"/api/admin/v1/hostnames","summary":"List custom hostnames","prefix":{"name":"get","color":"get"},"badges":[],"link":"/organizations/get_sm","deprecated":false},{"title":"/api/admin/v1/hostnames/{hostname}","summary":"Retrieve a custom hostname","prefix":{"name":"get","color":"get"},"badges":[],"link":"/organizations/get_im","deprecated":false},{"title":"/api/admin/v1/hostnames/{hostname}","summary":"Update a custom hostname","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/organizations/patch_am","deprecated":false},{"title":"/api/admin/v1/hostnames/{hostname}","summary":"Delete a custom hostname","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/organizations/delete_rm","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"schema_1264":{"kind":"json-schema","data":{"type":"object","properties":{"hostname":{"type":"string","description":"The unique name assigned to a custom hostname.","example":"sitecore-api-preview.example.com"},"defaultSiteId":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The default "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/xmc/en/developers/xm-cloud/get-the-environment-variables-for-a-site.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"site ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" associated with the custom hostname."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you don't specify a value for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"defaultSiteId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", you'll need to manually include it in the query parameter or body with each request to the custom hostname to ensure it is "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/resolving-a-custom-hostname-during-a-request.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"resolved correctly"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"playsummit"},"defaultContextId":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The default "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/xmc/en/developers/xm-cloud/the-context-id-environment-variable.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"context ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" associated with the custom hostname."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you don't specify a value for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"defaultContextId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", you'll need to manually include it in the query parameter or header with each request to the custom hostname to ensure it is "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/resolving-a-custom-hostname-during-a-request.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"resolved correctly"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"3BTl4aU7w12A5M76m9p8IA"}},"required":["hostname"]},"id":"schema_1264"},"schema_1265":{"kind":"json-schema","data":{"type":"object","properties":{"id":{"type":"string","description":"The custom hostname's unique identifier generated during creation.","example":"08de73f4-6f01-49b2-9ca6-d7fab7de966d"},"hostname":{"type":"string","description":"The unique name assigned to a custom hostname.","example":"sitecore-api-preview.example.com"},"defaultSiteId":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The default "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/xmc/en/developers/xm-cloud/get-the-environment-variables-for-a-site.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"site ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" associated with the custom hostname."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you don't specify a value for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"defaultSiteId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", you'll need to manually include it in the query parameter or body with each request to the custom hostname to ensure it is "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/resolving-a-custom-hostname-during-a-request.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"resolved correctly"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"playsummit"},"defaultContextId":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The default "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/xmc/en/developers/xm-cloud/the-context-id-environment-variable.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"context ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" associated with the custom hostname."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you don't specify a value for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"defaultContextId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", you'll need to manually include it in the query parameter or header with each request to the custom hostname to ensure it is "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/resolving-a-custom-hostname-during-a-request.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"resolved correctly"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"3BTl4aU7w12A5M76m9p8IA"},"ssl":{"type":"object","properties":{"expires_on":{"type":"string","description":"The SSL certificate's expiration date and time.","example":"2021-02-06T18:11:23.531995Z"},"method":{"type":"string","description":"The validation method used to verify the SSL certificate. \n\nExample values: \"txt\", \"html\"","example":"txt"},"status":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The current status of the SSL certificate."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example values: \"pending_validation\", \"active\"."},"children":[]}]}]}],"example":"active"},"validation_records":{"type":"array","items":{"type":"object","properties":{"txt_name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the TXT record used for DCV."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When adding this name to your DNS provider for DCV, you must exclude the domain name. For example, the TXT record name must be "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"_acme_challenge"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"_acme_challenge.sitecore-api-preview.example.com"},"txt_value":{"type":"string","description":"The value of the TXT record used for DCV.","example":"9kGetV9XSlo0VXSrU1sYHeEwc36xmkFY-a0J-4CGq8c"}}},"description":"The TXT records used for domain control validation (DCV)."},"validation_errors":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","description":"The error description.","example":"SERVFAIL looking up CAA for app.example.com"}}},"description":"Errors encountered during domain control validation."}},"required":["expires_on","method","status","validation_records","validation_errors"],"description":"The custom hostname's SSL properties, such as the domain control validation method, validation status, and related DNS records."},"ownership_verification":{"type":"object","properties":{"name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The DNS name required to verify ownership of the custom hostname."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When adding this name to your DNS provider to verify ownership of the custom hostname, you must exclude the domain name. For example, the DNS name must be "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"_cf_custom-hostname"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"_cf_custom-hostname.sitecore-api-preview.example.com"},"type":{"type":"string","description":"The DNS record type required to verify ownership of the custom hostname.","example":"txt"},"value":{"type":"string","description":"The DNS record value required to verify ownership of the custom hostname.","example":"e5e19fb0-0666-449d-a5ae-414f485dc63b"}},"required":["name","type","value"],"description":"The DNS records required to verify ownership of the custom hostname."},"created_at":{"type":"string","description":"The date and time the custom hostname was created.","example":"2021-02-06T18:11:23.531995Z"},"status":{"type":"string","description":"The current status of the custom hostname.\n\nExample values: \"pending\", \"active\".","example":"active"},"verification_errors":{"type":"array","items":{"type":"string","description":"The error description.","example":"SERVFAIL looking up CAA for app.example.com"},"description":"A list of errors that occurred while verifying the ownership of the custom hostname."}},"required":["id","hostname","ssl"]},"id":"schema_1265"},"schema_1266":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","description":"The HTTP response status code.","example":400},"title":{"type":"string","description":"The error description.","example":"BAD REQUEST"},"detail":{"type":"string","description":"The error details.","example":"URL format is invalid"},"type":{"type":"string","description":"URL to get more information about the error.","example":"https://datatracker.ietf.org/doc/html/rfc7231#section-6.5.1"},"instance":{"type":"string","description":"The instance where the error was encountered.","example":"https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames"}},"required":["status","title","detail","type","instance"]},"id":"schema_1266"},"schema_1267":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","description":"The HTTP response status code.","example":401},"title":{"type":"string","description":"The error description.","example":"UNAUTHORIZED"},"detail":{"type":"string","description":"The error details.","example":"Authentication credentials are required to access the resource. All requests must be authenticated."},"type":{"type":"string","description":"URL to get more information about the error.","example":"https://datatracker.ietf.org/doc/html/rfc7235#section-3.1"},"instance":{"type":"string","description":"The instance where the error was encountered.","example":"https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames"}},"required":["status","title","detail","type","instance"]},"id":"schema_1267"},"schema_1268":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","description":"The HTTP response status code.","example":403},"title":{"type":"string","description":"The error description.","example":"FORBIDDEN"},"detail":{"type":"string","description":"The error details.","example":"No access to the requested resource"},"type":{"type":"string","description":"URL to get more information about the error.","example":"https://datatracker.ietf.org/doc/html/rfc7231#section-6.5.3"},"instance":{"type":"string","description":"The instance where the error was encountered.","example":"https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames"}},"required":["status","title","detail","type","instance"]},"id":"schema_1268"},"schema_1269":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","description":"The HTTP response status code.","example":409},"title":{"type":"string","description":"The error description.","example":"CONFLICT"},"detail":{"type":"string","description":"The error details.","example":"The custom hostname already exists."},"type":{"type":"string","description":"URL to get more information about the error.","example":"https://datatracker.ietf.org/doc/html/rfc7231#section-6.5.8"},"instance":{"type":"string","description":"The instance where the error was encountered.","example":"https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames"}},"required":["status","title","detail","type","instance"]},"id":"schema_1269"},"schema_1270":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","description":"The HTTP response status code.","example":422},"title":{"type":"string","description":"The error description.","example":"UNPROCESSABLE ENTITY"},"detail":{"type":"string","description":"The error details.","example":"The maximum number of custom hostnames has been reached."},"type":{"type":"string","description":"URL to get more information about the error.","example":"https://datatracker.ietf.org/doc/html/rfc7231#section-6.5.1"},"instance":{"type":"string","description":"The instance where the error was encountered.","example":"https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames"}},"required":["status","title","detail","type","instance"]},"id":"schema_1270"},"schema_1271":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","description":"The HTTP response status code.","example":500},"title":{"type":"string","description":"The error description.","example":"INTERNAL SERVER ERROR"},"detail":{"type":"string","description":"The error details.","example":"The server was unable to complete your request. Please try again later."},"type":{"type":"string","description":"URL to get more information about the error.","example":"https://datatracker.ietf.org/doc/html/rfc7231#section-6.6.1"},"instance":{"type":"string","description":"The instance where the error was encountered.","example":"https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames"}},"required":["status","title","detail","type","instance"]},"id":"schema_1271"},"schema_1272":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","description":"The HTTP response status code.","example":404},"title":{"type":"string","description":"The error description.","example":"RESOURCE NOT FOUND"},"detail":{"type":"string","description":"The error details.","example":"The specified resource does not exist."},"type":{"type":"string","description":"URL to get more information about the error.","example":"https://datatracker.ietf.org/doc/html/rfc7231#section-6.5.4"},"instance":{"type":"string","description":"The instance where the error was encountered.","example":"https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames"}},"required":["status","title","detail","type","instance"]},"id":"schema_1272"},"schema_1273":{"kind":"json-schema","data":{"type":"string","description":"The specific custom hostname you want to interact with.","example":"sitecore-api-preview.example.com"},"id":"schema_1273"},"schema_1274":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","description":"The HTTP response status code.","example":400},"title":{"type":"string","description":"The error description.","example":"BAD REQUEST"},"detail":{"type":"string","description":"The error details.","example":"URL format is invalid"},"type":{"type":"string","description":"URL to get more information about the error.","example":"https://datatracker.ietf.org/doc/html/rfc7231#section-6.5.1"},"instance":{"type":"string","description":"The instance where the error was encountered.","example":"https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames/example.com"}},"required":["status","title","detail","type","instance"]},"id":"schema_1274"},"schema_1275":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","description":"The HTTP response status code.","example":401},"title":{"type":"string","description":"The error description.","example":"UNAUTHORIZED"},"detail":{"type":"string","description":"The error details.","example":"Authentication credentials are required to access the resource. All requests must be authenticated."},"type":{"type":"string","description":"URL to get more information about the error.","example":"https://datatracker.ietf.org/doc/html/rfc7235#section-3.1"},"instance":{"type":"string","description":"The instance where the error was encountered.","example":"https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames/example.com"}},"required":["status","title","detail","type","instance"]},"id":"schema_1275"},"schema_1276":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","description":"The HTTP response status code.","example":403},"title":{"type":"string","description":"The error description.","example":"FORBIDDEN"},"detail":{"type":"string","description":"The error details.","example":"No access to the requested resource"},"type":{"type":"string","description":"URL to get more information about the error.","example":"https://datatracker.ietf.org/doc/html/rfc7231#section-6.5.3"},"instance":{"type":"string","description":"The instance where the error was encountered.","example":"https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames/example.com"}},"required":["status","title","detail","type","instance"]},"id":"schema_1276"},"schema_1277":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","description":"The HTTP response status code.","example":404},"title":{"type":"string","description":"The error description.","example":"RESOURCE NOT FOUND"},"detail":{"type":"string","description":"The error details.","example":"The specified resource does not exist."},"type":{"type":"string","description":"URL to get more information about the error.","example":"https://datatracker.ietf.org/doc/html/rfc7231#section-6.5.4"},"instance":{"type":"string","description":"The instance where the error was encountered.","example":"https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames/example.com"}},"required":["status","title","detail","type","instance"]},"id":"schema_1277"},"schema_1278":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","description":"The HTTP response status code.","example":500},"title":{"type":"string","description":"The error description.","example":"INTERNAL SERVER ERROR"},"detail":{"type":"string","description":"The error details.","example":"The server was unable to complete your request. Please try again later."},"type":{"type":"string","description":"URL to get more information about the error.","example":"https://datatracker.ietf.org/doc/html/rfc7231#section-6.6.1"},"instance":{"type":"string","description":"The instance where the error was encountered.","example":"https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames/example.com"}},"required":["status","title","detail","type","instance"]},"id":"schema_1278"},"schema_1279":{"kind":"json-schema","data":{"type":"object","properties":{"defaultSiteId":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The default "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/xmc/en/developers/xm-cloud/get-the-environment-variables-for-a-site.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"site ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" associated with the custom hostname."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you don't specify a value for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"defaultSiteId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", you'll need to manually include it in the query parameter or body with each request to the custom hostname to ensure it is "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/resolving-a-custom-hostname-during-a-request.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"resolved correctly"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"playsummit"},"defaultContextId":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The default "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/xmc/en/developers/xm-cloud/the-context-id-environment-variable.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"context ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" associated with the custom hostname."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you don't specify a value for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"defaultContextId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", you'll need to manually include it in the query parameter or header with each request to the custom hostname to ensure it is "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/resolving-a-custom-hostname-during-a-request.html"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"resolved correctly"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"3BTl4aU7w12A5M76m9p8IA"}}},"id":"schema_1279"},"schema_1280":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","description":"The HTTP response status code.","example":422},"title":{"type":"string","description":"The error description.","example":"UNPROCESSABLE ENTITY"},"detail":{"type":"string","description":"The error details.","example":"The maximum number of custom hostnames has been reached."},"type":{"type":"string","description":"URL to get more information about the error.","example":"https://datatracker.ietf.org/doc/html/rfc7231#section-6.5.1"},"instance":{"type":"string","description":"The instance where the error was encountered.","example":"https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames/example.com"}},"required":["status","title","detail","type","instance"]},"id":"schema_1280"}},"exampleStore":{},"securitySchemeStore":{"BearerAuth":{"id":"BearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}},"servers":[{"url":"https://edge-platform-admin-api.sitecorecloud.io","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/portal/edge-platform-admin-rest-api/index.json?download"},{"url":"/_bundle/portal/edge-platform-admin-rest-api/index.yaml?download"}],"excludeFromSearch":false,"replayFeatures":{"graphql":false},"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Edge Platform Admin API","description":"Use the Edge Platform Admin API to create, retrieve, update, and delete custom hostnames in your organization.\n\n This REST API lets you interact with:\n\n - The custom hostname object. Use a [custom hostname](https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/custom-hostnames.html) to serve content or direct traffic to specific web services or applications under your organization's domain.\n\nAfter creating a custom hostname, you must:\n\n - [Register the hostname](https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/set-up-a-custom-hostname.html#add-the-cname-and-txt-records-to-your-domains-dns-record). Add the CNAME and TXT records to verify domain ownership. \n\n - [Check the status](https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/set-up-a-custom-hostname.html#check-the-status-of-your-custom-hostname). Ensure that it is active before using the hostname. \n\nNote the following:\n\n - You must have an [*Organization Admin* or *Organization Owner* role](https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/roles.html#organization-roles) in Sitecore Cloud Portal.\n\n - To use this REST API, you must authenticate your API requests.\n\n - All API requests are made in your production environment.\n\nFor more information, see the [official Sitecore Portal developer documentation](https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/introduction-to-the-sitecore-cloud-portal.html).\n\n## Authentication\n\nThe Edge Platform Admin API uses bearer authentication.\n\nBearer authentication involves security tokens called bearer tokens, which are generated in response to a login request.\n\nTo get the [bearer token](https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/manage-api-tokens.html):\n\n 1. Log in to [Sitecore Cloud Portal](https://portal.sitecorecloud.io/).\n\n 2. In the top-right corner of the menu bar, click your profile ![profile](https://resources.doc.sitecore.com/assets/image/uuid-b9b63de7-4dd2-ed95-8901-29afe1d1bf30.PNG) > **API tokens**.\n\n 3. Click **Copy to clipboard**.\n\nYou can now start making REST API requests. You must include this token in the authorization header of every request you make.","product":"Cloud Portal"}},"baseSlug":"/portal/edge-platform-admin-rest-api","routesMapping":{}}