> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alcamine.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Overview of the Alcamine REST API and authentication model

## Welcome to the Alcamine API

The **Alcamine REST API** lets you programmatically create, manage and interact with your agents, people, sessions and messages. Anything you can do in the Alcamine dashboard can also be done via these endpoints, enabling powerful automation and integrations.

### Base URL

```
https://api.alcamine.com/v1
```

The `/v1` prefix is fixed for the current API version.

## Authentication

All requests must be authenticated with a Bearer token.

1. Sign in to the **Alcamine Dashboard**.
2. Navigate to **Settings → API Keys**.
3. Click **Generate Key** to create a new secret key. Keys **always** start with `sk_alc_`.
4. Copy the key and include it in the `Authorization` header of every request.

```bash theme={null}
curl --request GET "https://api.alcamine.com/v1/agents" \\
  --header "Authorization: Bearer sk_alc_yourSecretKey" \\
  --header "Content-Type: application/json"
```

If the key is missing, invalid, or revoked, the API will respond with **401 Unauthorized**.