Skip to main content

​
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.
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.