# Authentication

> Create API tokens and make your first authenticated request.

Source: https://docs.avenlith.com/en/api-authentication  
Category: API & automation  
Last updated: 2026-09-20

## Tokens

Create a token under **Project → API tokens**. Tokens are scoped to one project and can be read-only or read-write.

## Request

Send the token as a bearer header:

```bash
curl https://api.avenlith.com/v1/servers \
  -H "Authorization: Bearer $AVENLITH_TOKEN"
```

## Response

```json
{
  "data": [
    { "id": "srv_8f2k1", "name": "web-01", "region": "ist1", "status": "running" }
  ],
  "meta": { "page": 1, "total": 1 }
}
```

## Rate limits

The API allows 3,600 requests per hour per token. The remaining quota is returned in the `X-RateLimit-Remaining` header.