Skip to main content
Agents API is currently in early beta. The API may change before general availability.
The agent operates in sandboxed environments where they can execute code, access the web, manage files, and complete multistep tasks, all streaming results back in real-time. The API is powered by Raccoon AI’s Agents SDK.

​
Key Concepts

​
Sessions

Persistent workspaces identified by a UUID. The agent maintains context across turns: files, conversation history, credentials and processes persist.

​
Turns

Single request-response cycles. Each turn builds on previous context within the same session. The agent sees prior work and continues incrementally.

​
Modes

Control how the agent works:
ModeUse case
autoGeneral-purpose (default)
codeSoftware development
deepsearchResearch and analysis
slidesPresentations
planPlanning before execution

​
How It Works

1

Start a turn

POST /sessions/new with your prompt, mode, and session_id.
2

Stream results

Connect to wss://api.raccoonai.tech/ws/sessions/{sessionId} to receive events as the agent executes.
3

Continue or branch

Reuse the same session_id to continue the session, or generate a new UUID to start fresh.

​
Endpoints

MethodEndpointDescription
POST/sessions/newStart a turn
GET/sessionsList sessions
GET/sessions/{sessionId}Get session details
PUT/sessions/{sessionId}/titleRename session
DEL/sessions/{sessionId}Delete session
PUT/media/uploadUpload files
WSS/ws/sessions/{sessionId}Real-time events

​
Rate Limits

Rate limits are enforced based on your plan. The X-Rate-Limit-Max-Concurrent header indicates the maximum turns you can run simultaneously. Exceeding limits returns 429 with an X-Rate-Limit-Retry-After header. For custom limits and pricing, contact sales.