API Overview - Uncloud

The Uncloud API is a RESTful interface for managing all platform resources. Every action available in the dashboard is also available through the API.

Base URL

http://localhost:8080/api/v1

All endpoints are prefixed with /api/v1.

Authentication

Include your API token in the request header:

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  http://localhost:8080/api/v1/droplets

See Authentication for details on creating and managing tokens.

Request Format

Content-Type: application/json for all POST/PATCH requests
Accept: application/json for all responses

Response Format

All responses follow a consistent JSON structure:

Success Response

{
  "id": "dpl_a1b2c3d4",
  "name": "my-droplet",
  "status": "running",
  "created_at": "2024-01-15T10:30:00Z"
}

List Response

[
  { "id": "dpl_a1b2c3d4", "name": "web-1" },
  { "id": "dpl_e5f6g7h8", "name": "web-2" }
]

Error Response

{
  "error": "droplet not found"
}

HTTP Methods

Method	Usage
`GET`	Retrieve resources
`POST`	Create resources or trigger actions
`PATCH`	Partially update resources
`DELETE`	Remove resources

Resource ID Prefixes

Resource	Prefix	Example
Project	`proj_`	`proj_default`
Droplet	`dpl_`	`dpl_a1b2c3d4`
Volume	`vol_`	`vol_e5f6g7h8`
App	`app_`	`app_i9j0k1l2`
Database	`db_`	`db_m3n4o5p6`
SSH Key	`sk_`	`sk_q7r8s9t0`

Rate Limiting

The API does not currently enforce rate limits, but this may change in future versions.

API Sections

Droplets

Create, manage, and monitor virtual machines

Apps

Deploy and manage applications

Volumes

Block storage management

Databases

Managed database instances

Object Storage

S3-compatible buckets and objects

SSH Keys

SSH key management

Clusters

Kubernetes cluster management

Webhooks

Event-driven integrations

​Base URL

​Authentication

​Request Format

​Response Format

​Success Response

​List Response

​Error Response

​HTTP Methods

​Resource ID Prefixes

​Rate Limiting

​API Sections