Cloud services, with a clearer local experience·Prices in ETB, same at renewal·Talk to our team →
✧ API REFERENCE

API reference.

JSON over HTTP with a bearer key. Small, because it only documents what you can actually call today — and it says what is missing.

local currency billingManaged cloudClear support
Base URL
https://api.hulubuild.cloud
Auth
Bearer API key
Format
JSON in, JSON out
Endpoints today
Reseller clients
01Authentication

One key, one scope, sent as a bearer token

Keys are created in your workspace, shown once, and hashed before they are stored. There is no way to recover a key — a lost one is revoked and replaced.

curl https://api.hulubuild.cloud/v1/reseller/clients \
  -H "Authorization: Bearer hbr_your_key_here"
Where keys come from
The reseller area of your workspace. Creating one shows it in full exactly once; after that only the first eight characters are visible, so you can tell your keys apart.
Scope
A key belongs to one service. A reseller key begins hbr_ and works only against the reseller endpoints — presented anywhere else it is not a weaker key, it is no key at all.
Revoking
Immediate. A revoked key is refused exactly as a key that never existed is, with no hint which it was.
The person behind the key
A key acts as the member who created it. If they leave the workspace, the key stops working with them.
02Reseller API

Manage the client workspaces you run

For agencies and resellers with an approved programme. Both endpoints act on the clients belonging to the key’s own workspace.

GET/v1/reseller/clients

Every client workspace you manage.

Request

curl https://api.hulubuild.cloud/v1/reseller/clients \
  -H "Authorization: Bearer hbr_your_key_here"

Response

{
  "clients": [
    { "id": "org_...", "name": "Abyssinia Cafe", "createdAt": "2026-11-20T09:14:02.511Z" }
  ]
}

POST/v1/reseller/clients

Creates a client workspace under your agency. Returns 201 with the new organisation. A name you already use is refused with duplicate_client rather than creating a second one.

Request

curl -X POST https://api.hulubuild.cloud/v1/reseller/clients \
  -H "Authorization: Bearer hbr_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"name":"Abyssinia Cafe"}'

Response

{
  "id": "org_...",
  "name": "Abyssinia Cafe"
}
03Errors

One shape, every time

Every failure is the same envelope, so a client can read the code without parsing prose. The message is written for a person; the code is what your software should branch on.

{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid API key."
  }
}
StatusCodeWhat it means
400validationA field is missing or outside its limits. The message names the field.
401invalid_api_keyNo key, a revoked key, or a key for a different service.
403agency_not_approvedThe programme has not been approved yet.
403email_unverifiedThe member who created the key has not verified their address.
409duplicate_clientA client of that name already exists in your workspace.
429rate_limitedToo many requests. Slow down and retry.
04Health

Is it up?

Two unauthenticated endpoints, safe to poll from a monitor.

GET /v1/health
Returns 200 while the service is running. Nothing about your account, so no key is needed.
GET /v1/health/ready
Returns 200 only when the service is ready to take traffic, and lists any setting that is unsafe or surprising on a deployed server.
The status page
For people rather than monitors, the status page shows the same thing in words.
05Honestly

What is not here yet

A reference that lists endpoints you cannot call wastes your afternoon. These are planned and not built, and this page will grow when they are.

Hosting, domains and servers
Ordering, provisioning and managing services is done in the console today. There is no public endpoint for it.
The AI Router
An allowance and a model endpoint exist in the platform, and the account-facing API for it is not published. See AI Router.
Webhooks
The platform receives them from providers. It does not yet send them to you.
SDKs
None. The API is small enough that curl and your language’s HTTP client are the whole integration.
A sandbox
No separate test environment. Ask us before you build against this.

Building something against this?

Tell us what you need to call and we will say honestly whether it exists, when it might, or whether the console is the only route today.

LET’S BUILD WHAT’S NEXT

Ready to explore HuluBuild Cloud?

Talk through a website, application or agency use case before choosing a plan.