Skip to main content
API v1.0

Build with the
relie API

Integrate community features into your app. Create threads, manage members, and enable real-time messaging.

Fast

Global edge network with <100ms response times.

Secure

JWT auth, rate limiting, row-level security.

RESTful

Intuitive endpoints. JSON in, JSON out.

Quick Start

Get up and running in minutes

1

Create an Account

Sign up at relie.app

2

Authenticate

Get your access token

3

Make API Calls

Include token in header

4

Handle Responses

All responses are JSON

javascript
const response = await fetch('https://relie.app/api/auth/login', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    email: 'user@example.com',
    password: 'your-password',
  }),
});

const { user, session } = await response.json();

Authentication

The API uses JWT tokens. Include the access token in all requests.

Header
Authorization: Bearer YOUR_ACCESS_TOKEN

Access Token

Short-lived (1 hour) for API requests.

Refresh Token

Long-lived for obtaining new tokens.

API Reference

Complete list of endpoints

POST/api/auth/register
POST/api/auth/login
POST/api/auth/logout
POST/api/auth/password-reset

Response Format

Consistent JSON responses

Success

json
{
  "thread": {
    "id": "uuid-here",
    "title": "My Community",
    "slug": "my-community",
    "is_public": true,
    "member_count": 42
  }
}

Error

json
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid input data",
    "details": ["title: Required"]
  }
}

HTTP Status Codes

200
OK
201
Created
400
Bad Request
401
Unauthorized
403
Forbidden
404
Not Found
429
Rate Limited
500
Server Error

Rate Limiting

Requests are rate limited for fair usage.

Authentication
10/min
Thread creation
5/min
General
100/min

Ready to Build?

Create your account and start building today.