Overview

Overview of the Cloud API surface, authentication, and how to create and rotate API keys.

Use the Cloud APIs to manage everything about Huddle01 Cloud Programmatically. Everything is authenticated with an API key and scoped to your workspace.

Base URL & auth

Base URL: https://cloud.huddleapis.com/api/v1
Send your secret as x-api-key: <your-key> on every request.
Most resources require region (e.g., eu2) and support pagination with limit (max 20) and offset.

Create an API key

Dashboard

Sign in at https://cloud.huddle01.com and select the target workspace.
Go to Usage & Billing → API Keys.
Click Create API Key, optionally set a name, and confirm.
Copy the secret right away, this is the only time it is shown. Store it in a secrets manager.
Use it with x-api-key on Cloud API calls.

Treat secrets carefully

Never commit API keys to Git. Rotate keys by creating a new one, updating clients, then revoking the old key. You can make a maximum of 5 active API keys per workspace.

First request

curl -X GET \
  "https://cloud.huddleapis.com/api/v1/instances?region=eu2&limit=10" \
  -H "x-api-key: $HUDDLE_API_KEY" \
  -H "Accept: application/json"

Overview

Base URL & auth

Create an API key

Dashboard

First request

On this page