Developer

API documentation

Create, manage, and delete hosted sites programmatically. Available on Solo plans and above.

Authentication

All API requests require a Bearer token in the Authorization header. Generate your API key from account settings.

Authorization: Bearer hup_your_api_key_here

GET

/api/v1/sites

List all your sites.

Response

{ "sites": [{ "id", "title", "slug", "status", "primaryUrl" }] }

POST

/api/v1/sites

Create a new site.

Request body

multipart/form-data with file, title, slug, and optional password

Response

{ "site": { "id", "slug", "url", "title" } }

GET

/api/v1/sites/:siteId

Get a specific site.

Response

{ "site": { "id", "title", "slug", "status", "primaryUrl" } }

DELETE

/api/v1/sites/:siteId

Delete a site permanently.

Response

{ "deleted": true }

API requests are rate limited to 60 requests per minute per API key. If you exceed this limit, you will receive a 429 response.