## Create an API key

`POST https://getkollek.com/api/administration/api`

Create a new API key for your user. The plain-text token is returned once in this response and cannot be retrieved later, so store it somewhere safe.

### Body parameters

- `label` (string, required): A name identifying what the key is used for. Maximum 255 characters.

**Returns:** The created api_key object. The plain-text token appears in the token attribute and at the top level of the response.

### Example request

```bash
curl https://getkollek.com/api/administration/api \
  -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "GitHub Actions"
}'
```

### Example response

`Status: 201`

```json
{
    "data": {
        "type": "api_key",
        "id": "1",
        "attributes": {
            "name": "GitHub Actions",
            "token": "3|aB4cD5eF6gH7iJ8kL9mN0oP1qR2sT3uV4wX5yZ6b",
            "last_used_at": 1752537600,
            "created_at": 1752537600,
            "updated_at": 1752537600
        },
        "links": {
            "self": "https://getkollek.com/api/administration/api/1"
        }
    },
    "token": "3|aB4cD5eF6gH7iJ8kL9mN0oP1qR2sT3uV4wX5yZ6b"
}
```