Hubfly spaceDocs
Console

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/v1

There is no sandbox

Every request runs against production data on your real account. Test with a throwaway project, and issue tokens with only the scopes the job needs. Seeauthentication for how to scope one.

Building a multi-tenant product?

Use developer sub-accounts to create isolated customer wallets, projects, resources, and machine identities. Tenant keys use ordinary resource paths; platform keys target a tenant with 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
curl https://api.hubfly.space/api/v1/projects \
  -H "Authorization: Bearer $HUBFLY_TOKEN"
curl — with a body
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.

JSON
{
  "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:

JSON
{
  "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.

GroupPath prefixEndpointsCovers
Projects & Workloads/api/v1/projects173Deployments, containers, volumes, load balancers, GPU, hibernation, and environment variables
Hubfly space Mail/api/v1/projects/:projectId/mail77Mail projects, addresses, domains, routing, credentials, templates, and activity
Box virtual machines/api/v1/projects/:projectId/boxes74Virtual machines, operations, disks, networking, firewalls, and monitoring
Managed Streams/api/v1/streams73Live video and audio servers: inputs, channels, mixers, restream destinations, playlists, schedules, recordings, playback keys, webhooks, graphics, domains, and live control
Managed Databases/api/v1/databases42PostgreSQL, MySQL, and SQLite (libSQL): connections, credentials, users, databases, tokens, SQL, export and import, sessions, insights, and configuration
Organizations & Teams/api/v1/organizations38Organization management, team members, semesters, budgets, and access groups
Realtime/api/v1/realtime35Pusher-compatible WebSocket servers: apps, keys, app bindings, events, history, channels, connections, webhooks, and the debug console
Web Analytics/api/v1/analytics33Cookieless site analytics: sites, domain verification, reports, exports, goals, funnels, segments, shared dashboards, ingest keys, and usage
Object Storage & Media/api/v1/projects/:projectId/storage32Project buckets, S3-compatible object operations, asset delivery, and video processing
Project Transfers & Moves/api/v1/moves30Give a project to another account or organization, move it to another region, and read its move history
Authentication/api/v1/auth27User login, registration, sessions, API tokens, and password management
Managed services/api/v1/managed27Shared by Managed Databases, Realtime and Streams: catalog, pricing, instances, lifecycle, operations, network, logs, metrics, and alerts
CLI & Automated Deployments/api/v1/cli15CLI authentication, container deployment sessions, and build status
Other endpoints/api/v1/other15Endpoints that do not belong to a documented group yet
Developer Sub-accounts/api/v1/subaccounts12Isolated customer tenants, wallets, machine credentials, and lifecycle controls
Domains & DNS/api/v1/domains6Custom domain registration, DNS verification, and domain removal
GitHub Integration/api/v1/github5Branch listing, repository sync, and GitHub access
Billing & Subscriptions/api/v1/billing4Checkout sessions and subscription details
GPU Computing/api/v1/gpu4GPU instance provisioning, status, and compute resources
Platform Credentials/api/v1/platform3Parent-scoped service credentials for managing and operating sub-accounts
Courses & Assignments/api/v1/courses3Course management and assignment administration
System Status/api/v1/system2System health check and status telemetry
Marketplace/api/v1/marketplace1One-click app templates and marketplace listings
Infrastructure Regions/api/v1/regions1Available deployment regions and data centers
App Templates/api/v1/templates1Pre-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.

Where to go next

Something unclear or out of date? Emailsupport@hubfly.spaceBack to top