Developers

cybaaspace API documentation

Automate server provisioning, VPS lifecycle actions, extra IP management, package changes and prepaid wallet reporting with a clean JSON API.

Create API key View packages

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

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 packages

Returns active VPS and dedicated packages. 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 package

Returns one package by public UUID or 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 server from a package and OS image 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","create_management_link":false}'

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 package, resources, assigned IPs, billing date, status and latest metrics for one server.

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","package":{"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 prepaid 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 package

Queues an upgrade/downgrade. 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 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

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

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."}

Private VLAN API

Private VLANs let customers create isolated L2 networks with automatically allocated private subnets and attach VPS/dedicated services. Private adapters are added without a panel speed limit.

GET    /api/v1/private-networks
GET    /api/v1/private-networks/subnets   # allocator status
POST   /api/v1/private-networks     { "name": "Internal network" }
POST   /api/v1/private-networks/{uuid}/attach
DELETE /api/v1/private-networks/{uuid}/members/{membership_id}