Platform API

The Platform API for managing Nebula Block instances, SSH keys, API keys, object storage, and billing.

The Platform API manages everything that is not inference: compute instances, SSH keys, API keys, object storage, billing, and teams.

• Base URL: https://api.nebulablock.com

• Base path: /api/v1

• API_URL: https://api.nebulablock.com/api/v1

• Authentication: Authorization: Bearer <token or API key> — see Authentication

Responses share a common envelope: a data payload, a message string, and a status of success or failed. Some listing endpoints add a meta block for pagination.

Important: Several endpoints report business failures as HTTP 200 with "status": "failed" — a duplicate name, an exceeded quota, or a rejected operation does not necessarily arrive as a 4xx. Check the status field, not just the HTTP status code. Endpoints that behave this way say so.

Compute

Endpoint	Reference
GET /computing/products	List Products
GET /computing/images	List OS Images
POST /computing/instance	Create Instance
GET /computing/instances	List Instances
GET /computing/deleted-instances	List Deleted Instances
GET /computing/instance/{id}	Get Instance
GET /computing/instance/{id}/start	Start Instance
GET /computing/instance/{id}/stop	Stop Instance
GET /computing/instance/{id}/reboot	Reboot Instance
DELETE /computing/instance/{id}	Delete Instance
GET /computing/instance/{id}/firewall-rules	Firewall Rules
POST /computing/instance/{id}/firewall-rules	Firewall Rules
DELETE /computing/instance/{id}/firewall-rules/{rule_id}	Firewall Rules

SSH keys

Endpoint	Reference
GET /ssh-keys/	List SSH Keys
POST /ssh-keys/	Create SSH Key
PUT /ssh-keys/{id}	Rename SSH Key
DELETE /ssh-keys/{id}	Delete SSH Key

API keys

Endpoint	Reference
GET /keys	List API Keys
POST /keys	Create API Key
PUT /keys/{id}	Update API Key
DELETE /keys/{id}	Delete API Key

Billing

Endpoint	Reference
GET /users/credits	Get Credit Balance
GET /users/credits/history	Get Payment History
GET /users/invoices	List Invoices
GET /users/invoice-download/{invoice_id}	Download Invoice

Object storage

Note: Workspace responses carry a provider field identifying the storage backend, and the console appends a matching provider query parameter to every object storage call. The parameter is not required — the endpoints behave the same without it — but you will see it in browser traffic.

Endpoint	Reference
GET /object-storage/	List Storage Workspaces
POST /object-storage/	Create Storage Workspace
DELETE /object-storage/	Delete Storage Workspace
POST /object-storage/regenerate-key-pair	Regenerate Access Keys
GET /object-storage/buckets	List Buckets
POST /object-storage/bucket	Create Bucket
DELETE /object-storage/bucket	Delete Bucket
GET /object-storage/bucket/files	List Files
POST /object-storage/upload	Upload File
GET /object-storage/download-url	Get Download URL
DELETE /object-storage/file	Delete File
POST /object-storage/buckets/toggle-privacy	Toggle Bucket Privacy
GET /object-storage/usage-data	Get Storage Usage

Not yet documented

These endpoints are live but do not have reference pages yet. Their shapes are visible in the console's network traffic, and the guides linked below cover the same features through the UI:

Area	Base path	Guide
Teams, members, roles, and team keys	/teams	Teams
Usage and spend summaries	/usage	—
Account notifications	/notifications	—
Webhook configuration	/webhook-configs	—
Hardware store	/hardware	—
Storage workspace details	/object-storage/details	Object Storage
Direct object download	/object-storage/download, /object-storage/download-resource	Get Download URL covers the usual path

See also

• Authentication

• Inference API

• Glossary