VPSBG's dev hub
HomePricingKnowledge BaseContact us
HomePricingKnowledge BaseContact us
  1. IP Addresses
  • 👋 Hello
  • API Introduction
    • API Introduction
    • How to generate API key?
  • API Reference
    • User
      • 2FA
        • Get 2FA secret key
        • Enable 2FA
        • Disable 2FA
      • Update user
      • Get account information
    • Balance
      • Balance
      • Deposit funds
      • List balance transactions
    • Affiliate
      • Get affiliate information
      • List conversions
      • List payouts
      • Activate affiliate program
      • Update referral code
    • Invoices
      • List invoices
      • Download an invoice
      • Download invoices
    • Support
      • Tickets
        • List tickets
        • List departments
        • List related services
        • Get a ticket
        • Create new ticket
        • Reply to ticket
        • Mark ticket as resolved
        • Download attachment
      • List plans
      • Purchase support plan
      • Renew support plan
      • Cancel support plan
      • Undo cancel request
    • SSH Keys
      • Get an SSH Key
      • Update SSH Key
      • Delete SSH Key
      • List SSH keys
      • Add SSH Key
    • Servers
      • Scale
        • List plans
        • Calculate scale cost
        • Scale a server
      • Addons
        • List available addons
        • Scale addons
        • Calculate scale cost
        • Purchase new addons
        • Cancel addon
        • Undo cancel request
      • Rescue
        • Enable rescue mode
        • Disable rescue mode
      • List plans
      • List servers
      • Server status
      • Get a server
      • Server metrics
      • Bandwidth
      • Deploy new server
      • Start a server
      • Restart a server
      • Stop a server
      • Power off
      • Cancel server
      • Undo cancel request
      • Change password
      • Update hostname
      • Update SSH Keys
      • Modify ISOs
      • Restore
      • Renew server
      • Reinstall Server
      • Change Primary IP
      • Calculate renew amount
    • Plans
      • Plan addon
      • Plan promo-codes
    • Snapshots
      • List snapshots
      • Delete snapshot
    • Backups
      • List backups
      • Delete backup
    • Server Images
      • List server images
    • Floating IPs
      • List Floating IPs
      • Plans
      • Purchase Floating IPs
      • Attach Floating IP
      • Detach Floating IP
      • Cancel Floating IP
      • Delete Floating IP Cancellation
    • IP Addresses
      • Update IP address
        PATCH
    • Network Protection
      • Geo filter
        • Get current geo filter
        • Set geo filter
        • Update geo filter
        • Delete geo filter
      • Whitelist
        • Get status and list of IPs
        • Whitelist IP addresses
        • Update IP addresses list
        • Delete all rules
      • Blacklist
        • Get status and list of IPs
        • Blacklist IP addresses
        • Update IP addresses list
        • Delete all rules
      • General information
      • Bandwidth
      • List blocked IPs
      • List attacks
      • Get an attack
      • Attack bandwidth
    • Orders
      • List orders
      • Get an order
      • Delete order
      • Pay orders
      • Update order
      • Change renewal period
    • ISOs
      • Get an ISO
      • Delete an ISO
      • List ISOs
      • Add ISO
  1. IP Addresses

Update IP address

PATCH
/ip-addresses/{id}
IP address
This endpoint is used to update the IP address information.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
id
string 
required
Header Params
Accept
string 
required
Default:
application/json
Body Params application/json
ptr
required
Must be left empty if you want to remove it.
Any of
Example
{
    "ptr": "example.com"
    // for ipv6
    //"ptr": {
    //  "2001:0000:130F:0000:0000:09C0:876A:130B": "example.com"
    //}
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://api.vpsbg.eu/v1/ip-addresses/' \
--header 'Accept;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ptr": "example.com"
    // for ipv6
    //"ptr": {
    //  "2001:0000:130F:0000:0000:09C0:876A:130B": "example.com"
    //}
}'

Responses

🟢200Successfully updated IP address.
application/json
Body
id
integer 
required
Example:
417
ip_address
string 
required
The IP address.
Example:
87.120.37.46
prefix
integer 
required
Examples:
3264
version
integer 
required
Example:
4
type
string 
required
Example:
public
main
boolean 
required
ddos_protected
boolean 
required
Whether the IP is DDoS protected or not.
floating_ip
optional
Whether or not this IP is sold as a Floating IP.
Any of
Example:
{"id":205,"status":"active","ip":"87.120.37.47","server_id":2478,"expiry":"2023-07-31T21:00:00.000000Z","ddos":0}
id
integer 
optional
Example:
1
status
string 
optional
Status of the IP address as a service.
Example:
active
server_id
integer  | null 
optional
The server identification number to which this IP address is attached to.
Example:
2586
server_hostname
string 
required
Server's hostname
Example:
ubuntu-2g
locked
boolean  | null 
required
Default:
false
locked_at
string  | null 
optional
Example:
2024-11-24T22:00:00.000000Z
lock_reason
string  | null 
required
Example:
floating-ip-attach
billing_cycle
integer 
required
Example:
3
expiry_at
string 
optional
The expiration date of the IP address.
Example:
2025-09-29T21:00:00.000000Z
plan
object 
required
cancel_request
object  | null 
optional
ptr
object  | null 
optional
{IP_ADDRESS}
string 
required
Example:
example.com
assigned_on
string 
required
Datetime when the IP address was assigned to your account.
Example
{
  "id": 417,
  "ip_address": "87.120.37.46",
  "prefix": 32,
  "version": 4,
  "type": "public",
  "main": true,
  "ddos_protected": true,
  "floating_ip": {
    "id": 205,
    "status": "active",
    "ip": "87.120.37.47",
    "server_id": 2478,
    "expiry": "2023-07-31T21:00:00.000000Z",
    "ddos": 0
  },
  "ptr": {
    "{IP_ADDRESS}": "example.com"
  },
  "assigned_on": "string"
}
🔴500Server Error
Modified at 2024-09-17 11:04:35
Previous
Delete Floating IP Cancellation
Next
Get current geo filter
Built with