Authentication

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

Getting an API Key

Log in to Raccoon AI
Click your profile picture in the top right
Select Manage Account
Go to API Keys
Click Add new key
Copy and securely store your API key

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

Using Your API Key

Include your API key in the Authorization header of all requests:

Authorization: Bearer YOUR_API_KEY

Example Request

curl -X GET https://api.raccoonai.tech/chats \
  -H "Authorization: Bearer sk_live_abc123xyz"

import requests

API_KEY = "sk_live_abc123xyz"

response = requests.get(
    "https://api.raccoonai.tech/chats",
    headers={"Authorization": f"Bearer {API_KEY}"}
)

const API_KEY = "sk_live_abc123xyz";

const response = await fetch("https://api.raccoonai.tech/chats", {
  headers: { "Authorization": `Bearer ${API_KEY}` }
});

WebSocket Authentication

For WebSocket connections, pass the token as a query parameter:

wss://api.raccoonai.tech/ws/chat/{taskId}?token=YOUR_API_KEY&message_id={messageId}&last_stream_entry_id=0-0

Authentication Errors

401 Unauthorized

Returned when the API key is missing or invalid:

{
  "error": "unauthorized",
  "message": "Invalid or missing API key"
}

403 Forbidden

Returned when the API key doesn’t have permission for the requested resource:

{
  "error": "forbidden",
  "message": "You don't have access to this resource"
}

Overview

Sessions

Media

Getting an API Key

Using Your API Key

Example Request

WebSocket Authentication

Authentication Errors

401 Unauthorized

403 Forbidden

​Getting an API Key

​Using Your API Key

​Example Request

​WebSocket Authentication

​Authentication Errors

​401 Unauthorized

​403 Forbidden

Getting an API Key

Using Your API Key

Example Request

WebSocket Authentication

Authentication Errors

401 Unauthorized

403 Forbidden