Authentication - Clustr

All API requests require a Bearer token in the Authorization header.

Authorization: Bearer <your_api_key>

Creating an API key

Go to the API settings page
Click Create New Key
Copy the key immediately. It won’t be shown again

You can create up to 10 API keys per workspace.

Check a key

GET /api/public/test-key answers 200 with your workspace id when the key works. Tools that offer a “test connection” button can call it.

curl https://api.clustr-ai.com/api/public/test-key \
  -H "Authorization: Bearer $CLUSTR_API_KEY"

Example

curl https://api.clustr-ai.com/api/public/target-accounts \
  -H "Authorization: Bearer clstr_abc123..."

import requests

headers = {"Authorization": "Bearer clstr_abc123..."}
response = requests.get(
    "https://api.clustr-ai.com/api/public/target-accounts",
    headers=headers
)

const response = await fetch(
  "https://api.clustr-ai.com/api/public/target-accounts",
  { headers: { Authorization: "Bearer clstr_abc123..." } }
);

req, _ := http.NewRequest("GET",
    "https://api.clustr-ai.com/api/public/target-accounts", nil)
req.Header.Set("Authorization", "Bearer clstr_abc123...")
resp, _ := http.DefaultClient.Do(req)

Error responses

Status	Meaning
`401`	Missing or invalid API key
`403`	API key does not have access to this resource