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.

Base URL

https://api.replr.ai/v1

Resources

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=0

Error 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