Skip to main content

​
Getting Started

Realm provides REST APIs for using agents and managing documents from your own applications. Create an API key to start using the API. See API Keys for how to create and manage keys.

​
Base URL

Use the following base URL for all API requests: 
https://app.withrealm.com/api/external/alpha

​
Authentication

All API requests require authentication using a Bearer token: 
curl -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  https://app.withrealm.com/api/external/alpha/agents

​
Available APIs

Chats - Create conversations with agents, continue existing chats, and retrieve or delete chat history. Supports both standard and streaming responses. Documents - Create, update, retrieve, and delete documents in your custom connectors. You can also upload files directly for indexing into your knowledge base. Connectors - List the API connectors available in your organization. Use connector IDs when working with the Documents API. Agents - List the agents your API key has access to. Use agent IDs when creating chats.

​
Rate Limits

The API uses rate limiting to ensure fair usage. If you exceed the limit, you’ll receive a 429 Too Many Requests response. Each endpoint has a rate limit of 600 requests per minute, enforced separately per endpoint. If you exceed the rate limit, the request will be queued for up to 3 seconds before being rejected. We recommend implementing exponential backoff in your client applications when receiving 429 responses.

​
Need Help?

If you encounter any issues or have questions, please contact our team in Slack or via email: support@withrealm.com