API reference
REST endpoints for sessions, agents, webhooks, teams, and more.
MCP tools
10 Model Context Protocol tools for AI agents to manage sessions.
Webhooks
Real-time event notifications with HMAC-signed payloads.
Session schema
The canonical JSON schema for sessions, timeline events, and media.
Claude Code skill
Pull and execute work from Already sessions with
/already.Authentication
Already supports three authentication methods depending on the caller:| Method | Prefix | Use case |
|---|---|---|
| Cookie JWT | — | Browser-based web app calls |
| Agent API key | ak_ | AI agent integrations |
| Personal API key (PAK) | pak_ | User-scoped API and MCP access |
X-Team-Id header to specify the team context.
Base URL
All API and MCP requests usehttps://already.so as the base URL.