LEIA Customer API

API for interacting with LEIA instances.

Requirements

• Node.js 16+
• PNPM
• Redis

Usage

Start the server

npm start

Start the server in development mode

npm dev

API

The API provides the following endpoints:

Create a LEIA instance

POST /api/v1/leias

Headers:

Authorization: Bearer YOUR_RUNNER_KEY

Body:

{
  "sessionId": "unique-session-id",
  "leia": {
    "spec": {
      "persona": { ... },
      "behaviour": { ... },
      "problem": { ... }
    }
  },
  "runnerConfiguration": {
    "provider": "openai"
  }
}

Responses:

• 201 Created: LEIA created successfully
• 400 Bad Request: Required parameters missing
• 401 Unauthorized: Invalid authentication token
• 409 Conflict: Session with the same ID already exists
• 500 Internal Server Error: Internal server error

Send message to a LEIA instance

POST /api/v1/leias/:sessionId/messages

Headers:

Authorization: Bearer YOUR_RUNNER_KEY

Body:

{
  "message": "Your message for LEIA"
}

Responses:

• 200 OK: Message processed successfully
• 400 Bad Request: Required parameters missing
• 401 Unauthorized: Invalid authentication token
• 404 Not Found: Session with the provided ID not found
• 500 Internal Server Error: Internal server error

List available models

GET /api/v1/models

Headers:

Authorization: Bearer YOUR_RUNNER_KEY

Response:

{
  "models": ["openai", "openai-responses", "openai-advanced"],
  "default": "openai-advanced"
}

Responses:

• 200 OK: List of models retrieved successfully
• 401 Unauthorized: Invalid authentication token
• 500 Internal Server Error: Internal server error

Documentation

API documentation is available at:

http://localhost:5000/docs