Management API

The Management API lets you manage the HostBase platform from scripts, CI/CD or your own tools. Don't confuse it with a project's data API (/rest/v1) — this API manages the projects themselves.

Authentication

Create a personal access token in Account → Access tokens and send it in a header:

Authorization: Bearer hb_pat_xxxxxxxxxxxxxxxxxxxx

Base URL: https://host.ulewicz.space/api/v1. Responses are JSON.

Organizations and projects

curl -X POST https://host.ulewicz.space/api/v1/projects \
  -H "Authorization: Bearer $HOSTBASE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"shop-prod","organization_slug":"acme","region":"pl-waw-1","compute_size":"small"}'

{
  "ref": "abcdefghijklmnopqrst",
  "name": "shop-prod",
  "status": "provisioning",
  "region": "pl-waw-1",
  "api_url": "https://abcdefghijklmnopqrst.host.ulewicz.space"
}

Database

curl -X POST https://host.ulewicz.space/api/v1/projects/abcdefghijklmnopqrst/database/query \
  -H "Authorization: Bearer $HOSTBASE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"select now() as time, version()"}'

Point-in-time recovery and branches

Edge Functions and secrets

Network, domains and regions

Error codes