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

# Change Server IP Address

> Moves a server onto a new IPv4 address in the same location for a one-time
fee of €2.50 (VAT of your country included), paid from your account balance.
The server keeps its data.

The change then runs on its own, usually within a few minutes; follow it with
`GET /ip-changes/{ipChange}`. A Linux server restarts once and boots with new
SSH host keys, so SSH drops for a minute or two. On a Windows server, Remote
Desktop drops for about a minute while the address switches. The old address
is released afterwards, and its reverse DNS goes with it. An IPv6 address, if
the server has one, changes with it.

A change that fails puts the server back on its old address, and the fee is
credited back to your balance.




## OpenAPI

````yaml post /servers/{server}/ip-changes
openapi: 3.1.0
info:
  title: APIFiddle Sample Definition
  version: 0.0.0
  description: Example workspace
servers:
  - url: https://rdp.sh/api/v1
    description: Default production endpoint.
security: []
paths:
  /servers/{server}/ip-changes:
    post:
      summary: Change a server's IP address
      description: >
        Moves a server onto a new IPv4 address in the same location for a
        one-time

        fee of €2.50 (VAT of your country included), paid from your account
        balance.

        The server keeps its data.


        The change then runs on its own, usually within a few minutes; follow it
        with

        `GET /ip-changes/{ipChange}`. A Linux server restarts once and boots
        with new

        SSH host keys, so SSH drops for a minute or two. On a Windows server,
        Remote

        Desktop drops for about a minute while the address switches. The old
        address

        is released afterwards, and its reverse DNS goes with it. An IPv6
        address, if

        the server has one, changes with it.


        A change that fails puts the server back on its old address, and the fee
        is

        credited back to your balance.
      operationId: changeServerIp
      parameters:
        - $ref: '#/components/parameters/server'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - subnet
              properties:
                subnet:
                  type: string
                  description: >
                    The /24 to take the new address from, one of `subnets` in
                    the

                    options. The server's current subnet can be chosen too.
                  examples:
                    - 198.51.100.0/24
      responses:
        '201':
          content:
            application/json:
              schema:
                type: object
                title: ChangeServerIpOk
                required:
                  - status
                  - message
                  - invoice_id
                  - amount_charged
                  - ip_change
                properties:
                  status:
                    type: boolean
                    examples:
                      - true
                  message:
                    type: string
                    examples:
                      - The IP address change has been queued
                  invoice_id:
                    type: integer
                    examples:
                      - 5013
                  amount_charged:
                    type: number
                    examples:
                      - 2.5
                  ip_change:
                    $ref: '#/components/schemas/ipChange'
          description: The change was paid from your balance and queued.
        '400':
          content:
            application/json:
              schema:
                type: object
                title: ChangeServerIpBadRequest
                properties:
                  status:
                    type: boolean
                    examples:
                      - false
                  error:
                    type: string
                    examples:
                      - Insufficient balance
                  required:
                    type: number
                    examples:
                      - 2.5
                  available:
                    type: number
                    examples:
                      - 1
          description: Insufficient balance.
        '403':
          content:
            application/json:
              schema:
                type: object
                title: ChangeServerIpUnauthorized
                properties:
                  status:
                    type: boolean
                    examples:
                      - false
                  error:
                    type: string
                    examples:
                      - This action is unauthorized
          description: User does not own the server.
        '404':
          description: Server not found.
        '409':
          content:
            application/json:
              schema:
                type: object
                title: ChangeServerIpConflict
                properties:
                  status:
                    type: boolean
                    examples:
                      - false
                  error:
                    type: string
                    examples:
                      - >-
                        198.51.100.0/24 has no free address for this server.
                        Please choose another subnet.
                  ip_change:
                    $ref: '#/components/schemas/ipChange'
          description: >
            The change cannot be made: the subnet has no free address, the
            server

            cannot change its address right now, or the change has to be made by
            our

            support team. Nothing is charged. If the payment was taken and the
            change

            refused at that moment, `ip_change` is included and the fee is
            already

            back on your balance.
        '422':
          description: Validation error (missing `subnet`, or one that is not a /24).
      security:
        - Authorization: []
components:
  parameters:
    server:
      in: path
      name: server
      schema:
        type: string
      required: true
  schemas:
    ipChange:
      type: object
      required:
        - id
        - server_id
        - status
        - subnet
      properties:
        id:
          type: integer
          examples:
            - 42
        server_id:
          type: integer
          examples:
            - 123
        status:
          type: string
          enum:
            - awaiting_payment
            - pending
            - running
            - completed
            - failed
          description: >
            `awaiting_payment` is only seen for a change ordered on the server
            page

            whose invoice is still open.
          examples:
            - running
        step:
          type: string
          description: What the change is doing right now.
          examples:
            - Waiting for the server on its new address
        progress:
          type: integer
          minimum: 0
          maximum: 100
          examples:
            - 80
        subnet:
          type: string
          description: The /24 the new address is taken from.
          examples:
            - 198.51.100.0/24
        old_ip:
          type:
            - string
            - 'null'
          examples:
            - 203.0.113.10
        new_ip:
          type:
            - string
            - 'null'
          description: >
            The address the server is moving to, once it has been reserved.
            `null`

            again if the change failed.
          examples:
            - 198.51.100.20
        invoice_id:
          type:
            - integer
            - 'null'
        refunded:
          type: boolean
          description: Whether the fee was credited back to your balance.
        error:
          type:
            - string
            - 'null'
          description: Why the change failed, once it has.
        created_at:
          type: string
          examples:
            - '2026-10-22T12:00:00+00:00'
        finished_at:
          type:
            - string
            - 'null'
      description: A change of a server's IPv4 address.
  securitySchemes:
    Authorization:
      in: header
      name: Authorization
      type: apiKey
      description: |
        Your API key as it is, without `Bearer`. API access is off for new
        accounts: until it is turned on under Settings > API, every request
        answers `403` with `API access is turned off for this account. Turn it
        on under Settings > API.` If the account lists allowed IPs, a request
        from any other address answers `403` with `This API key is not allowed
        from <address>`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.