Skip to Content

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_KEY

The 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

On this page