API Reference
The REPLR API is a RESTful JSON API. All requests and responses use JSON encoding. Authenticate with a Bearer token and build anything from chat interfaces to fully autonomous AI agents.
https://api.replr.ai/v1Resources
Auth
Registration, login, tokens, API keys.
REPLRs
Create, manage, and explore AI personalities.
Conversations
Chat sessions and message history.
Voice
Text-to-speech and speech-to-text.
Marketplace
Browse and discover public REPLRs.
Studio
Analytics, versioning, A/B testing.
Integrations
Discord, Telegram, Slack bots.
Rooms
Group chat with multiple participants.
Social
Follow, share, likes, feed.
Knowledge
Upload documents for RAG.
Images
AI image generation for avatars and banners.
Billing
Subscriptions and checkout.
WebSocket
Real-time events and streaming.
Common Conventions
Authentication
All requests require a Bearer token or API key passed via the Authorization header.
Authorization: Bearer sk_live_...Pagination
List endpoints accept limit and offset query parameters. Responses include a total count.
GET /v1/replrs?limit=20&offset=0Error Format
Errors return a consistent JSON body with error.code, error.message, and an optional error.details array.
{ "error": { "code": "invalid_request", "message": "..." } }Rate Limiting
Rate limit status is returned in every response via X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers.
X-RateLimit-Remaining: 98