API
Hubfly space REST API
Manage projects and platform resources with JSON over HTTPS. Box, Managed Databases and Realtime are managed through these authenticated Dashboard endpoints. Storage's S3 endpoint, Mail's direct sending protocols and the Realtime WebSocket and server protocol have their own credentials and reference pages.
Base URL and versioning
All endpoints live under a single host and are versioned in the path. The current version is v1, and it will not change shape underneath you: additive changes ship as new fields and new endpoints, and anything breaking would land on a new version prefix.
https://api.hubfly.space/api/v1There is no sandbox
Building a multi-tenant product?
X-Hubfly space-Subaccount.Making a request
Authenticate with a bearer token in the Authorization header. Requests with a body send JSON and set Content-Type: application/json.
curl https://api.hubfly.space/api/v1/projects \
-H "Authorization: Bearer $HUBFLY_TOKEN"curl -X POST https://api.hubfly.space/api/v1/projects/create \
-H "Authorization: Bearer $HUBFLY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "frontend-service", "region": "us-east-1"}'Response envelope
Successful responses wrap the payload in data and carry request metadata inmeta. The resource is never at the top level, so parsing code can be uniform across endpoints.
{
"data": {
"id": "proj_8f3a1d9",
"name": "frontend-service",
"region": "us-east-1",
"createdAt": "2026-07-20T11:04:52.000Z"
},
"meta": {
"requestId": "req_2c91ba4"
}
}Failures use the same envelope with an error object in place of the data:
{
"error": {
"code": "project_not_found",
"message": "Project not found"
},
"meta": {
"requestId": "req_2c91ba4"
}
}Errors and status codes lists what each status means and which failures are worth retrying.
Resource groups
The API exposes 733 endpoints, grouped by the resource they act on. Each group below maps to a section in the endpoint explorer.
| Group | Path prefix | Endpoints | Covers |
|---|---|---|---|
| Projects & Workloads | /api/v1/projects | 173 | Deployments, containers, volumes, load balancers, GPU, hibernation, and environment variables |
| Hubfly space Mail | /api/v1/projects/:projectId/mail | 77 | Mail projects, addresses, domains, routing, credentials, templates, and activity |
| Box virtual machines | /api/v1/projects/:projectId/boxes | 74 | Virtual machines, operations, disks, networking, firewalls, and monitoring |
| Managed Streams | /api/v1/streams | 73 | Live video and audio servers: inputs, channels, mixers, restream destinations, playlists, schedules, recordings, playback keys, webhooks, graphics, domains, and live control |
| Managed Databases | /api/v1/databases | 42 | PostgreSQL, MySQL, and SQLite (libSQL): connections, credentials, users, databases, tokens, SQL, export and import, sessions, insights, and configuration |
| Organizations & Teams | /api/v1/organizations | 38 | Organization management, team members, semesters, budgets, and access groups |
| Realtime | /api/v1/realtime | 35 | Pusher-compatible WebSocket servers: apps, keys, app bindings, events, history, channels, connections, webhooks, and the debug console |
| Web Analytics | /api/v1/analytics | 33 | Cookieless site analytics: sites, domain verification, reports, exports, goals, funnels, segments, shared dashboards, ingest keys, and usage |
| Object Storage & Media | /api/v1/projects/:projectId/storage | 32 | Project buckets, S3-compatible object operations, asset delivery, and video processing |
| Project Transfers & Moves | /api/v1/moves | 30 | Give a project to another account or organization, move it to another region, and read its move history |
| Authentication | /api/v1/auth | 27 | User login, registration, sessions, API tokens, and password management |
| Managed services | /api/v1/managed | 27 | Shared by Managed Databases, Realtime and Streams: catalog, pricing, instances, lifecycle, operations, network, logs, metrics, and alerts |
| CLI & Automated Deployments | /api/v1/cli | 15 | CLI authentication, container deployment sessions, and build status |
| Other endpoints | /api/v1/other | 15 | Endpoints that do not belong to a documented group yet |
| Developer Sub-accounts | /api/v1/subaccounts | 12 | Isolated customer tenants, wallets, machine credentials, and lifecycle controls |
| Domains & DNS | /api/v1/domains | 6 | Custom domain registration, DNS verification, and domain removal |
| GitHub Integration | /api/v1/github | 5 | Branch listing, repository sync, and GitHub access |
| Billing & Subscriptions | /api/v1/billing | 4 | Checkout sessions and subscription details |
| GPU Computing | /api/v1/gpu | 4 | GPU instance provisioning, status, and compute resources |
| Platform Credentials | /api/v1/platform | 3 | Parent-scoped service credentials for managing and operating sub-accounts |
| Courses & Assignments | /api/v1/courses | 3 | Course management and assignment administration |
| System Status | /api/v1/system | 2 | System health check and status telemetry |
| Marketplace | /api/v1/marketplace | 1 | One-click app templates and marketplace listings |
| Infrastructure Regions | /api/v1/regions | 1 | Available deployment regions and data centers |
| App Templates | /api/v1/templates | 1 | Pre-configured application templates |
Conventions
Identifiers
IDs are opaque prefixed strings — proj_, cnt_,vol_, lb_, sub_. Treat them as strings: do not parse them, and do not assume a length.
Timestamps
All timestamps are ISO 8601 in UTC, for example2026-07-20T11:04:52.000Z. There is no local-time variant.
Verbs in paths
Mutating endpoints spell the action out in the path — /projects/create,/projects/:projectId/delete — rather than relying on the HTTP method alone. The method still matters, but the path tells you what a request does at a glance in a log.
Partial updates
Update endpoints replace the collection they are given rather than merging into it. Firewall rules and environment variables in particular are set wholesale: read the current value, modify it, and send the complete list back.