API Reference

Comprehensive technical documentation for Elousias' REST and WebSocket APIs, SDKs, and authentication workflows.

Authentication

API Keys

Use an API key for programmatic access. Generate one in your account settings.

Authorization: Bearer YOUR_API_KEY

OAuth2

OAuth2 is supported for third-party integrations. Follow our OAuth guide for implementation.

POST /oauth/token

Base URL

https://api.elousias.dev/v1

All endpoints are relative to this base URL. Use /real-time for WebSocket connections.

API Endpoints

GET /users/{id}

Retrieve user profile
Parameters
  • id (required) - User identifier
Response Example
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "username": "johndoe",
  "created_at": "2025-01-01T00:00:00Z"
}

POST /projects

Create a new project
Parameters
  • name (required) - Project name
  • team_id (optional) - Team identifier
Request Example
{
  "name": "My First Project",
  "team_id": "12345"
}

Code Examples

cURL Example

curl -X GET "https://api.elousias.dev/v1/users/12345" 
-H "Authorization: Bearer YOUR_API_KEY"

JavaScript SDK

import { ElousiasClient } from '@elousias/core';

const client = new ElousiasClient({ apiKey: 'YOUR_API_KEY' });
const user = await client.users.get('12345');
```