Authentication

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:

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

Response#

{
  "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.