> Index of every page on this site: [llms.txt](https://docs.a-line.cloud/llms.txt)

# 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](/api/authentication) as a bearer token. Put the key in a variable
so the commands below run as they are:

```sh
export ALC_API_KEY=alc_...
```

## List clusters

```sh
curl https://api.a-line.cloud/v1/clusters \
  -H "Authorization: Bearer $ALC_API_KEY"
```

The request it sends:

```http api
GET /v1/clusters
Authorization: Bearer $ALC_API_KEY
```

The answer is one [page](/api/pagination) of clusters. Copy the `id` of the
cluster the project should run on:

```json api op=list_clusters status=200
{
  "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](/getting-started/create-cluster) first.

## Create a project

Put the cluster ID in the path:

```sh
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"}'
```

```http api
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:

```json api op=create_project status=201
{
  "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](/api/errors). To retry a create safely, send an
[idempotency key](/api/idempotency).

## Next steps

- Find the operation you need in the [reference](/api/reference).
- Page through long lists with [pagination](/api/pagination).
- Read the [rate limits](/api/rate-limits) before scripting many calls.
