> ## Documentation Index
> Fetch the complete documentation index at: https://gcore.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Change CDN service details

> Change CDN service details of the specific client account.



## OpenAPI

````yaml /api-reference/services_documented/cdn_reseller_api.yaml put /cdn/clients/{client_id}
openapi: 3.1.0
info:
  title: Gcore OpenAPI – CDN Reseller 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: '2026-05-15T06:37:28.230198+00:00'
servers:
  - url: https://api.gcore.com
security:
  - APIKey: []
tags:
  - name: CDN Reseller Account
    description: Information about CDN product settings in your account.
    x-displayName: Account
  - name: CDN Reseller service
    description: Information about the current state of CDN service in your account.
    x-displayName: CDN service
  - name: CDN Reseller Features
    description: Information about free and paid features available for you account.
    x-displayName: Features
  - name: Balancer
    description: >-
      Balancer allows choosing CDN server locations that will be used for
      content delivery.


      To activate balancer, [set client’s balancer
      settings](/docs/api-reference/cdn-resellers/balancer/set-client-balancer-settings).
    x-displayName: Balancer
  - name: CDN Reseller Origin shielding
    description: >-
      Origin shielding helps protect your origin server from being overloaded
      with requests from multiple CDN servers.

      The option accumulates all CDN server requests at a special server called
      a shield or precache server.


      When shielding is enabled, only one precache server communicates with the
      origin host, not the entire CDN.
    x-displayName: Origin shielding
paths:
  /cdn/clients/{client_id}:
    put:
      tags:
        - CDN Reseller service
      summary: Change CDN service details
      description: Change CDN service details of the specific client account.
      operationId: change-cdn-service-details
      parameters:
        - $ref: '#/components/parameters/path_client_id'
      requestBody:
        $ref: '#/components/requestBodies/ChangeAccountDetails'
      responses:
        '200':
          $ref: '#/components/responses/AccountDetails'
        '400':
          $ref: '#/components/responses/ChangeAccountDetailsFailed'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  parameters:
    path_client_id:
      name: client_id
      in: path
      required: true
      schema:
        allOf:
          - $ref: '#/components/schemas/body_response_client_ID'
  requestBodies:
    ChangeAccountDetails:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ChangeAccountDetails'
          example:
            utilization_level: 500
  responses:
    AccountDetails:
      description: Successful.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/AccountDetails'
          examples:
            default:
              $ref: '#/components/examples/AccountDetails'
    ChangeAccountDetailsFailed:
      description: Invalid value of "utilization_level" parameter is provided.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ChangeAccountDetailsFailed'
    NotFound:
      description: The client is not found.
  schemas:
    body_response_client_ID:
      type: integer
      description: Client account ID.
    ChangeAccountDetails:
      type: object
      properties:
        utilization_level:
          allOf:
            - $ref: '#/components/schemas/body_request_clients_UtilizationLevel'
    AccountDetails:
      type: object
      properties:
        id:
          allOf:
            - $ref: '#/components/schemas/body_response_client_ID'
        created:
          allOf:
            - $ref: '#/components/schemas/body_response_client_Created'
        updated:
          allOf:
            - $ref: '#/components/schemas/body_response_client_Updated'
        service:
          allOf:
            - $ref: '#/components/schemas/body_response_client_Service'
        utilization_level:
          allOf:
            - $ref: '#/components/schemas/body_response_client_UtilizationLevel'
        cname:
          allOf:
            - $ref: '#/components/schemas/body_response_client_Cname'
        use_balancer:
          allOf:
            - $ref: '#/components/schemas/body_response_client_UseBalancer'
        auto_suspend_enabled:
          allOf:
            - $ref: '#/components/schemas/body_response_client_AutoSuspendEnabled'
    ChangeAccountDetailsFailed:
      description: Invalid value of "utilization_level" parameter is provided.
      type: object
      properties:
        errors:
          type: object
          properties:
            utilization_level:
              type: array
              description: >-
                The specified limit has an unacceptable value. The value must be
                greater than or equal to 0.
              items:
                type: string
              example:
                - Ensure this value is greater than or equal to 0.
    body_request_clients_UtilizationLevel:
      type: integer
      description: >-
        CDN traffic usage limit in gigabytes.


        The value must be greater than or equal to 0.


        When the limit is reached, we will send an email notification to the
        client.
    body_response_client_Created:
      type: string
      description: Date of the first synchronization with the Platform.
    body_response_client_Updated:
      type: string
      description: Date of the last CDN service update.
    body_response_client_Service:
      type: object
      description: CDN service status.
      properties:
        enabled:
          allOf:
            - $ref: '#/components/schemas/body_response_service_Enabled'
        status:
          allOf:
            - $ref: '#/components/schemas/body_response_service_Status'
        updated:
          allOf:
            - $ref: '#/components/schemas/body_response_service_Updated'
    body_response_client_UtilizationLevel:
      type: integer
      description: >-
        CDN traffic usage limit in gigabytes.


        When the limit is reached, we will send an email notification to a
        client.
    body_response_client_Cname:
      type: string
      description: >-
        Domain zone to which a CNAME record of the client CDN resources should
        be pointed.
    body_response_client_UseBalancer:
      type: boolean
      description: Defines whether custom balancing is used for content delivery.
    body_response_client_AutoSuspendEnabled:
      type: boolean
      description: >-
        Defines whether resources will be deactivated automatically by
        inactivity.
      example: true
    body_response_service_Enabled:
      type: boolean
      description: |-
        Defines whether the service is activated.

        Possible values are:
        - **true** - Service is activated.
        - **false** - Service is not activated.
    body_response_service_Status:
      type: string
      description: >-
        Service status.


        Possible values:

        - **new** - CDN service is not activated.

        - **trial** - Free trial is in progress.

        - **trialend** - Free trial has ended and CDN service is stopped. All
        client CDN resources are suspended.

        - **activating** - CDN service is being activated. It can take up to 15
        minutes.

        - **active** - CDN service is active.

        - **paused** - CDN service is stopped. All client CDN resources are
        suspended.

        - **deleted** - CDN service is stopped. All client CDN resources are
        deleted.
    body_response_service_Updated:
      type: string
      description: Date of the last status update.
  examples:
    AccountDetails:
      value:
        id: 1
        created: '2017-06-10T10:30:04.954354Z'
        updated: '2017-06-10T10:30:04.954354Z'
        service:
          enabled: true
          status: active
          updated: '2017-06-10T10:30:04.954354Z'
        utilization_level: 500
        cname: cli-1-hash.example.com
        use_balancer: false
  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

````