1. Getting Started
  2. Authentication

​
API Key Authentication

All Backboard API requests require authentication using an API key. Include your API key in the X-API-Key header with every request.

curl -X GET "https://app.backboard.io/api/assistants" \
  -H "X-API-Key: your_api_key"

​
Getting Your API Key

  1. Log in to Backboard Dashboard
  2. Navigate to Settings → API Keys
  3. Click Create New API Key
  4. Copy and securely store your API key

API keys are only shown once when created. If you lose your key, you’ll need to generate a new one.

​
Using the API Key

import requests

headers = {"X-API-Key": "your_api_key"}
response = requests.get(
    "https://app.backboard.io/api/assistants",
    headers=headers
)

​
Security Best Practices

​
Error Responses

If authentication fails, you’ll receive a 401 Unauthorized response:

{
  "detail": "Invalid or missing API key"
}