> ## Documentation Index > Fetch the complete documentation index at: https://docs.gcore.com/llms.txt > Use this file to discover all available pages before exploring further. # Change alias > Change an alias. The hostname and the CDN resource of an alias cannot be changed; delete the alias and create a new one instead. Set `active` to **false** to stop serving the alias; set it back to **true** to resume. For an alias with your own certificate, pass a new certificate ID in `ssl_id` to replace it. The new certificate must cover the alias hostname. ## OpenAPI ````yaml /api-reference/services_docs_mintlify_enriched/cdn_api.yaml patch /cdn/aliases/{alias_id} openapi: 3.1.0 info: title: Gcore OpenAPI – CDN API description: >- This OpenAPI is an aggregated OpenAPI specification that unifies all Gcore products into a single file. It covers Cloud, CDN, DNS, WAAP, DDoS Protection, Object Storage, Streaming, and FastEdge services. version: e232bb9ff2d2 servers: - url: https://api.gcore.com security: - APIKey: [] tags: - name: CDN service description: Information about the current state of the CDN service in your account. - name: CDN resources - name: Origins - name: Rules description: >- Rules allow to set up custom settings for certain file types or paths. By default, the rule inherits all options values from the related CDN resource. Each option in rule settings can be in one of the following states: - **Inherit** - Option is not added to the rule. Option inherits its value from the CDN resource settings. In this case, the option value is **null**. - **ON** - Option is added to the rule and enabled. Option values configured in the rule will override values from the CDN resource settings. - **OFF** - Option is added to the rule and disabled. Option will be turned off. - name: Rule templates - name: Presets description: >- A preset is a predefined set of CDN resource or rule settings that can be applied to an object in a single request. Once a preset is applied to an object, the options included in the preset cannot be edited on that object until the preset is unapplied. - name: SSL certificates - name: Let's Encrypt certificates - name: CA certificates - name: Aliases description: >- An alias is a hostname you own that is served with the settings of one of your CDN resources and with its own SSL certificate. Aliases must be enabled for your account. - name: CDN activity logs description: |- Get the history of users requests to CDN. It contains requests made both via the API and via the control panel. The following methods are not tracked in the activity logs: - HEAD - OPTIONS - name: Log viewer description: >- Log viewer provides you with general information about CDN operation. This information does not contain all possible sets of fields and restricted by time. To receive full data, use Logs Uploader. - name: Logs uploader description: >- Logs uploader allows you to upload logs with desired format to desired storages. Consists of three main parts: - **Policies** - rules that define which logs are uploaded and how they are uploaded. - **Targets** - destinations where logs are uploaded. - **Configs** - combinations of logs uploader policies, targets and resources to which they are applied. - name: Tools - name: Statistics description: >- Consumption statistics is updated in near real-time as a standard practice. However, the frequency of updates can vary, but they are typically available within a 24-hour period. Exceptions, such as maintenance periods, may delay data beyond 24 hours until servers resume and fill in the missing statistics. - name: Advanced analytics description: >- Advanced analytics allows to get statistics about unique visitors, traffic, and requests for countries, directories, browsers, devices, and operation systems for up to 90 days starting from today. Advanced analytics API is based on the [GraphQL framework](https://graphql.org/). Advanced analytics API has one single endpoint: https://api.gcore.com/cdn/advanced/v2/query You can pass the query parameters as a JSON object in the payload of a POST request to this endpoint. You can use curl to make requests to the Advanced analytics API. Alternatively, you can use a GraphQL client to construct queries and pass requests to the Advanced analytics API. You can write queries in GraphQL much like in SQL: specify the data set (CDN resource), the metrics to retrieve (such as unique visitors and traffic), and filter or group by dimensions (for example, a country). - name: Origin shielding - name: IP addresses list - name: Purge history paths: /cdn/aliases/{alias_id}: patch: tags: - Aliases summary: Change alias description: >- Change an alias. The hostname and the CDN resource of an alias cannot be changed; delete the alias and create a new one instead. Set `active` to **false** to stop serving the alias; set it back to **true** to resume. For an alias with your own certificate, pass a new certificate ID in `ssl_id` to replace it. The new certificate must cover the alias hostname. operationId: change-alias parameters: - $ref: '#/components/parameters/alias_id_parameter' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ChangeAlias' responses: '200': description: Successful. content: application/json: schema: $ref: '#/components/schemas/Alias' '400': description: Validation failed. content: application/json: schema: $ref: '#/components/schemas/CommonValidationError' '403': description: Aliases are not enabled for your account. '404': description: The alias does not exist. components: parameters: alias_id_parameter: in: path name: alias_id description: Alias ID. required: true schema: type: integer schemas: ChangeAlias: type: object properties: active: type: boolean description: >- Whether the alias is enabled. Possible values: - **true** – The alias is enabled and is served once its certificate is ready. - **false** – The alias is paused and is not served. example: false ssl_id: type: integer description: >- ID of your own SSL certificate to serve for the alias instead of the current one. The certificate must cover the alias hostname; a Let's Encrypt certificate issued for one of your CDN resources cannot be used. Available only for aliases with `automated` set to **false**. example: 891 Alias: type: object properties: id: type: integer description: Alias ID. example: 123 cname: type: string description: Alias hostname. Cannot be changed after creation. example: shop.customer.com resource_id: type: integer description: >- ID of the CDN resource whose settings the alias is served with. Cannot be changed after creation. example: 4567 automated: type: boolean description: >- How the alias certificate is managed. Possible values: - **true** – A Let's Encrypt certificate is issued and renewed automatically. - **false** – The certificate referenced by `ssl_id` was added by you. example: true ssl_id: type: integer description: ID of the SSL certificate served for the alias. example: 890 active: type: boolean description: >- Whether you have enabled the alias. Enabling it does not by itself make it live: the alias is served only while `status` is **active**, **`ssl_issuing`** or **`ssl_error`**. Possible values: - **true** – The alias is enabled and is served once its certificate is ready. - **false** – The alias is paused and is not served. example: true enabled: type: boolean description: >- Whether the alias is enabled by the system. Follows the state of the CDN resource. Possible values: - **true** – The alias can be served. - **false** – The alias is not served because its CDN resource is not active. example: true status: $ref: '#/components/schemas/AliasStatus' created: type: string description: >- Date and time when the alias was created (ISO 8601/RFC 3339 format, UTC.) example: '2026-09-01T10:00:00Z' updated: type: string description: >- Date and time when the alias was last changed (ISO 8601/RFC 3339 format, UTC.) example: '2026-09-01T10:05:00Z' CommonValidationError: title: Other Errors type: object properties: errors: type: object description: This object contains error descriptions per field from your request. properties: field_name: type: array description: Error list for specific field. items: type: string description: Error description example: - Error description. AliasStatus: type: string description: >- Alias status. Possible values: - **pending** – The certificate has not been issued yet; the alias is not served. - **active** – The alias is served with its certificate. - **`ssl_issuing`** – A new certificate is being issued; the current one keeps being served. - **`ssl_error`** – Certificate issuance failed; a previously issued certificate keeps being served. - **inactive** – The alias or its CDN resource is disabled; the alias is not served. enum: - pending - active - ssl_issuing - ssl_error - inactive example: active securitySchemes: APIKey: description: >- API key for authentication. Make sure to include the word `apikey`, followed by a single space and then your token. Example: `apikey 1234_abcdef` type: apiKey in: header name: Authorization ````