Documentation Index
Fetch the complete documentation index at: https://docs.usesatori.sh/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Satori provides a type-safe tRPC API for all memory operations. This API is used internally by the@usesatori/tools package and can also be called directly for custom integrations.
Base URL
Authentication
All API requests require authentication via thex-api-key header:
API Structure
The Satori API is organized into two main routers:Memory Router
Operations for managing memories:memory.add- Save a new memorymemory.search- Search for relevant memoriesmemory.getAll- Get all memories for a usermemory.getById- Get a specific memory by IDmemory.delete- Delete a memory
Keys Router
Operations for managing API keys (dashboard use):keys.list- List all API keyskeys.create- Create a new API keykeys.revoke- Revoke an API key
Using tRPC Client
TypeScript/JavaScript
Install the tRPC client:React
Use with React Query:Rate Limits
| Limit Type | Value |
|---|---|
| Requests per minute | 100 |
| Concurrent requests | 10 |
| Max memories per user | Unlimited |
Rate limits are per API key. Contact support for higher limits.
Error Handling
All API errors follow this format:Common Error Codes
| Code | HTTP Status | Description |
|---|---|---|
UNAUTHORIZED | 401 | Invalid or missing API key |
BAD_REQUEST | 400 | Invalid request parameters |
NOT_FOUND | 404 | Resource not found |
TOO_MANY_REQUESTS | 429 | Rate limit exceeded |
INTERNAL_SERVER_ERROR | 500 | Server error |
Example Error Response
Request/Response Format
tRPC Queries (GET operations)
Queries use GET requests with query parameters:tRPC Mutations (POST operations)
Mutations use POST requests with JSON body:Batch Requests
tRPC supports batching multiple requests into one HTTP call:Health Check
Check API health:Next Steps
Memory Operations
Explore memory management endpoints
API Key Management
Learn about key management endpoints
Integration Guide
See the API in action
Direct Client
Use the MemoryClient wrapper