Your first request
List your clusters and create a project with an API key.
Every request goes to https://api.a-line.cloud/v1 and sends an
API key as a bearer token. Put the key in a variable
so the commands below run as they are:
export ALC_API_KEY=alc_...List clusters
curl https://api.a-line.cloud/v1/clusters \
-H "Authorization: Bearer $ALC_API_KEY"The request it sends:
GET /v1/clusters
Authorization: Bearer $ALC_API_KEYThe answer is one page of clusters. Copy the id of the
cluster the project should run on:
{
"data": [
{
"id": "5b1f0a52-8c4e-4d1b-9a77-2f6c3e8d1a40",
"name": "production",
"provider": "hetzner",
"region": "fsn1",
"state": "running",
"environment_id": "a3c2d9e8-1b7f-4e60-8d5a-6c4b2e1f0a93",
"created_at": "2026-10-01T09:30:00Z",
"capacity_wait": [],
"price_confirmation": []
}
],
"has_more": false,
"next_cursor": null
}An empty data list means the key's organization has no cluster yet:
create one first.
Create a project
Put the cluster ID in the path:
curl https://api.a-line.cloud/v1/clusters/5b1f0a52-8c4e-4d1b-9a77-2f6c3e8d1a40/projects \
-H "Authorization: Bearer $ALC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "web", "display_name": "Web"}'POST /v1/clusters/{cluster_id}/projects
Authorization: Bearer $ALC_API_KEY
Content-Type: application/json
{
"name": "web",
"display_name": "Web"
}A 201 Created answer holds the new project:
{
"id": "0d6e2f4a-7c1b-4e3d-9a58-1b2c3d4e5f60",
"cluster_id": "5b1f0a52-8c4e-4d1b-9a77-2f6c3e8d1a40",
"name": "web",
"display_name": "Web",
"isolated": false,
"egress_mode": "public",
"created_at": "2026-11-15T10:00:00Z"
}A second request with the same name fails with 409; every failure uses
the same error envelope. To retry a create safely, send an
idempotency key.
Next steps
- Find the operation you need in the reference.
- Page through long lists with pagination.
- Read the rate limits before scripting many calls.