Developers

cybaaspace API documentation

Automate server provisioning, VPS lifecycle actions, dedicated inventory orders, extra IP management and account reporting with a JSON API.

Create API key View servers

Authentication

Send your API key as a bearer token. API keys can be created in the client panel. Responses use public UUIDs instead of internal database IDs.

Authorization: Bearer csp_live_your_api_key

Search endpoints

GEThttps://cybaaspace.com/api/v1/balance

Show wallet balance

Returns the current USD prepaid wallet balance.

Example request

curl -X GET 'https://cybaaspace.com/api/v1/balance' \
  -H 'Authorization: Bearer csp_live_your_api_key'

Example response

{"ok":true,"data":{"balance":42.50,"currency":"USD"}}

GEThttps://cybaaspace.com/api/v1/transactions

Show transactions

Returns wallet transaction history. Supports ?limit=25&offset=0.

Example request

curl -X GET 'https://cybaaspace.com/api/v1/transactions' \
  -H 'Authorization: Bearer csp_live_your_api_key'

Example response

{"ok":true,"data":[{"type":"credit","amount":25,"balance_after":42.5,"description":"Wallet top-up","created_at":"2026-06-10 12:00:00"}]}

GEThttps://cybaaspace.com/api/v1/packages

List catalog

Returns active VPS packages and available dedicated inventory servers. Optional filter: ?type=vps or ?type=dedicated.

Example request

curl -X GET 'https://cybaaspace.com/api/v1/packages' \
  -H 'Authorization: Bearer csp_live_your_api_key'

Example response

{"ok":true,"data":[{"uuid":"...","slug":"starter","type":"vps","name":"Starter","monthly_price":6.95,"resources":{"cpu":2,"ram_mb":1024,"disk_gb":20}}]}

GEThttps://cybaaspace.com/api/v1/packages/{uuid-or-slug}

Show catalog item

Returns one VPS package by public UUID/slug or one dedicated inventory item by dedicated-server-ID slug.

Example request

curl -X GET 'https://cybaaspace.com/api/v1/packages/{uuid-or-slug}' \
  -H 'Authorization: Bearer csp_live_your_api_key'

Example response

{"ok":true,"data":{"uuid":"...","slug":"performance","name":"Performance","monthly_price":42.95}}

GEThttps://cybaaspace.com/api/v1/os-images

List OS images

Returns active OS images for provisioning or reinstall. Optional filter: ?type=vps or ?type=dedicated.

Example request

curl -X GET 'https://cybaaspace.com/api/v1/os-images' \
  -H 'Authorization: Bearer csp_live_your_api_key'

Example response

{"ok":true,"data":[{"uuid":"...","key":"ubuntu-24-04","name":"Ubuntu","version":"24.04"}]}

GEThttps://cybaaspace.com/api/v1/ssh-keys

List SSH keys

Returns SSH keys in your account so you can select one during server creation.

Example request

curl -X GET 'https://cybaaspace.com/api/v1/ssh-keys' \
  -H 'Authorization: Bearer csp_live_your_api_key'

Example response

{"ok":true,"data":[{"uuid":"...","label":"Laptop","fingerprint":"..."}]}

POSThttps://cybaaspace.com/api/v1/servers

Create VPS or dedicated service

Creates a new VPS from a package, or a dedicated server from dedicated inventory, using prepaid wallet balance.

Example request

curl -X POST 'https://cybaaspace.com/api/v1/servers' \
  -H 'Authorization: Bearer csp_live_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{"type":"vps","package_slug":"starter","os_image_key":"ubuntu-24-04","hostname":"web1.example.com","ssh_key_uuid":"optional-uuid","promo_code":"optional"} or {"type":"dedicated","dedicated_server_id":12,"os_image_key":"ubuntu-24-04","hostname":"dedicated1.example.com"}'

Example response

{"ok":true,"message":"Service ordered and queued for provisioning.","data":{"uuid":"...","hostname":"web1.example.com","service_status":"provisioning"}}

GEThttps://cybaaspace.com/api/v1/servers

List servers

Returns all visible VPS and dedicated services for the authenticated account.

Example request

curl -X GET 'https://cybaaspace.com/api/v1/servers' \
  -H 'Authorization: Bearer csp_live_your_api_key'

Example response

{"ok":true,"data":[{"uuid":"...","hostname":"web1","status":"Online","ips":[{"address":"203.0.113.10","type":"primary"}]}]}

GEThttps://cybaaspace.com/api/v1/servers/{uuid}

Show server

Returns product/resources, assigned IPs, billing date, status and latest metrics for one server. Dedicated servers use the linked inventory asset as product.

Example request

curl -X GET 'https://cybaaspace.com/api/v1/servers/{uuid}' \
  -H 'Authorization: Bearer csp_live_your_api_key'

Example response

{"ok":true,"data":{"uuid":"...","hostname":"web1","product":{"cpu":2,"ram_mb":2048,"disk_gb":40}}}

POSThttps://cybaaspace.com/api/v1/servers/{uuid}/start

Start server

Queues a start action when the service is allowed to start.

Example request

curl -X POST 'https://cybaaspace.com/api/v1/servers/{uuid}/start' \
  -H 'Authorization: Bearer csp_live_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{}'

Example response

{"ok":true,"message":"Start has been queued."}

POSThttps://cybaaspace.com/api/v1/servers/{uuid}/stop

Stop server

Queues a stop action.

Example request

curl -X POST 'https://cybaaspace.com/api/v1/servers/{uuid}/stop' \
  -H 'Authorization: Bearer csp_live_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{}'

Example response

{"ok":true,"message":"Stop has been queued."}

POSThttps://cybaaspace.com/api/v1/servers/{uuid}/restart

Restart server

Queues a restart action.

Example request

curl -X POST 'https://cybaaspace.com/api/v1/servers/{uuid}/restart' \
  -H 'Authorization: Bearer csp_live_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{}'

Example response

{"ok":true,"message":"Restart has been queued."}

POSThttps://cybaaspace.com/api/v1/servers/{uuid}/extend

Extend server

Extends the server using account balance. Extra IP add-ons are included in the renewal price.

Example request

curl -X POST 'https://cybaaspace.com/api/v1/servers/{uuid}/extend' \
  -H 'Authorization: Bearer csp_live_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{}'

Example response

{"ok":true,"message":"Service extended."}

POSThttps://cybaaspace.com/api/v1/servers/{uuid}/change-package

Change VPS package

VPS only. Queues an upgrade/downgrade. Dedicated servers are the physical inventory asset and cannot change package. Destructive disk downgrades require confirm_data_loss=true and erase_confirmation=ERASE.

Example request

curl -X POST 'https://cybaaspace.com/api/v1/servers/{uuid}/change-package' \
  -H 'Authorization: Bearer csp_live_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{"package_slug":"edge"}'

Example response

{"ok":true,"message":"Package change queued."}

POSThttps://cybaaspace.com/api/v1/servers/{uuid}/destroy

Destroy server

Queues a destructive remove action. The server is hidden from the customer dashboard immediately.

Example request

curl -X POST 'https://cybaaspace.com/api/v1/servers/{uuid}/destroy' \
  -H 'Authorization: Bearer csp_live_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{}'

Example response

{"ok":true,"message":"Destroy has been queued."}

POSThttps://cybaaspace.com/api/v1/servers/{uuid}/reinstall

Reinstall server

Queues a reinstall with the selected OS image. Data on the VPS disk or dedicated target disk will be erased.

Example request

curl -X POST 'https://cybaaspace.com/api/v1/servers/{uuid}/reinstall' \
  -H 'Authorization: Bearer csp_live_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{"os_image_key":"ubuntu-24-04"}'

Example response

{"ok":true,"message":"Reinstall has been queued."}

GEThttps://cybaaspace.com/api/v1/servers/{uuid}/share-links

List management links

Returns limited no-login management links created for this VPS. Full tokens are never returned after creation.

Example request

curl -X GET 'https://cybaaspace.com/api/v1/servers/{uuid}/share-links' \
  -H 'Authorization: Bearer csp_live_your_api_key'

Example response

{"ok":true,"data":[{"uuid":"...","label":"Customer link","token_preview":"csp_sh_abc...••••1234","permissions":{"start":true,"console":true}}]}

POSThttps://cybaaspace.com/api/v1/servers/{uuid}/share-links

Create management link

Creates a special secure URL for this VPS with only the permissions you enable.

Example request

curl -X POST 'https://cybaaspace.com/api/v1/servers/{uuid}/share-links' \
  -H 'Authorization: Bearer csp_live_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{"label":"Customer link","expires_at":"2026-07-10 23:59:59","permissions":{"start":true,"stop":true,"restart":true,"reinstall":true,"console":true,"stats":true}}'

Example response

{"ok":true,"data":{"uuid":"...","url":"https://cybaaspace.com/manage/csp_sh_..."}}

DELETEhttps://cybaaspace.com/api/v1/servers/{uuid}/share-links/{link_uuid}

Revoke management link

Revokes a guest management link immediately.

Example request

curl -X DELETE 'https://cybaaspace.com/api/v1/servers/{uuid}/share-links/{link_uuid}' \
  -H 'Authorization: Bearer csp_live_your_api_key'

Example response

{"ok":true,"message":"Management link revoked."}

GEThttps://cybaaspace.com/api/v1/servers/{uuid}/extra-ips

List extra IPs

VPS only. Returns the extra IP addresses assigned to a server, excluding the primary IP.

Example request

curl -X GET 'https://cybaaspace.com/api/v1/servers/{uuid}/extra-ips' \
  -H 'Authorization: Bearer csp_live_your_api_key'

Example response

{"ok":true,"data":[{"uuid":"...","address":"203.0.113.11","adapter":"net1","monthly_price":2}],"limits":{"max_extra_ips":5}}

POSThttps://cybaaspace.com/api/v1/servers/{uuid}/extra-ips

Add extra IP

VPS only. Adds one extra IPv4 address when available and charges the pro-rated add-on price.

Example request

curl -X POST 'https://cybaaspace.com/api/v1/servers/{uuid}/extra-ips' \
  -H 'Authorization: Bearer csp_live_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{}'

Example response

{"ok":true,"message":"Extra IPv4 address queued."}

DELETEhttps://cybaaspace.com/api/v1/servers/{uuid}/extra-ips/{ip_uuid}

Remove extra IP

Removes an extra IPv4 address. Primary IPs cannot be removed.

Example request

curl -X DELETE 'https://cybaaspace.com/api/v1/servers/{uuid}/extra-ips/{ip_uuid}' \
  -H 'Authorization: Bearer csp_live_your_api_key'

Example response

{"ok":true,"message":"Extra IPv4 removal queued."}

POSThttps://cybaaspace.com/api/v1/servers/{uuid}/extra-ips/{ip_uuid}/move

Move extra IP

Moves an extra IPv4 address to another VPS and applies any pro-rated billing adjustment.

Example request

curl -X POST 'https://cybaaspace.com/api/v1/servers/{uuid}/extra-ips/{ip_uuid}/move' \
  -H 'Authorization: Bearer csp_live_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{"target_server_uuid":"target-service-uuid"}'

Example response

{"ok":true,"message":"Extra IPv4 transfer queued."}

GEThttps://cybaaspace.com/api/v1/private-networks

List private VLANs

Returns private VLAN networks owned by the authenticated customer with member/service details.

Example request

curl -X GET 'https://cybaaspace.com/api/v1/private-networks' \
  -H 'Authorization: Bearer csp_live_your_api_key'

Example response

{"ok":true,"data":[{"uuid":"...","name":"Internal network","subnet":"10.40.12.0/24","vlan_id":4012,"members":2}]}

GEThttps://cybaaspace.com/api/v1/private-networks/subnets

Private VLAN allocator status

Returns allocator availability and pool status. Subnets are assigned automatically when a private network is created.

Example request

curl -X GET 'https://cybaaspace.com/api/v1/private-networks/subnets' \
  -H 'Authorization: Bearer csp_live_your_api_key'

Example response

{"ok":true,"data":{"available":42,"allocated":8,"mode":"automatic"}}

POSThttps://cybaaspace.com/api/v1/private-networks

Create private VLAN

Creates an isolated L2 private network with an automatically allocated private subnet.

Example request

curl -X POST 'https://cybaaspace.com/api/v1/private-networks' \
  -H 'Authorization: Bearer csp_live_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Internal network"}'

Example response

{"ok":true,"message":"Private network created.","data":{"uuid":"...","subnet":"10.40.12.0/24"}}

POSThttps://cybaaspace.com/api/v1/private-networks/{uuid}/attach

Attach service to private VLAN

Queues a private adapter on a VPS or dedicated service without applying a panel speed limit.

Example request

curl -X POST 'https://cybaaspace.com/api/v1/private-networks/{uuid}/attach' \
  -H 'Authorization: Bearer csp_live_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{"server_uuid":"service-uuid"}'

Example response

{"ok":true,"message":"Private adapter queued."}

DELETEhttps://cybaaspace.com/api/v1/private-networks/{uuid}/members/{membership_id}

Remove private VLAN member

Removes a service membership from a private VLAN and queues adapter cleanup where supported.

Example request

curl -X DELETE 'https://cybaaspace.com/api/v1/private-networks/{uuid}/members/{membership_id}' \
  -H 'Authorization: Bearer csp_live_your_api_key'

Example response

{"ok":true,"message":"Private network member removal queued."}