Rei Chat quickstart

The Agent API manages Units and their configuration. Use the Inference API to send messages to a Unit and receive generated responses.

APIs at a glance

API	Base URL	Scope	Auth
Agent API	`https://api.reilabs.org/v1`	Create, configure, and manage agents (units) and their tools	Account API Key and Unit API Key (per endpoint)
Inference API	`https://rei-api.reilabs.org/v1`	Run chat completions and generate responses from an agent	Unit API Key

All paths are versioned under /v1. Always send your credential in the Authorization header as a bearer token: Authorization: Bearer <SECRET_KEY>.

Agent API

Base URL: https://api.reilabs.org/v1 Use the Agent API to create or configure Units. The endpoint determines which credential authorizes the call.

Account & Unit Management

Use your Account API Key for operations that create or change agents on your account.

Method	Endpoint	Description
`POST`	`/accounts/units`	Create a new agent (unit)
`PUT`	`/accounts/units`	Update an existing agent
`DELETE`	`/accounts/units`	Delete an agent
`POST`	`/accounts/units/clone`	Clone an existing agent

Agent Operations

Use the agent’s Unit API Key to read its details or update its tools.

Method	Endpoint	Description
`GET`	`/agents`	Retrieve the agent’s details
`GET`	`/agents/tools`	List the agent’s tools
`PUT`	`/agents/tools`	Update the agent’s tools

Inference API

Base URL: https://rei-api.reilabs.org/v1 Send messages to a configured agent through the Inference API. Authenticate with that agent’s Unit API Key.

Chat & Responses

Method	Endpoint	Description
`POST`	`/chat-completion`	Run a chat completion against the agent
`POST`	`/response`	Generate a response from the agent

Authentication

Choose the credential required by the endpoint:

Credential	Used for	Endpoints
Account API Key	Managing resources across your account	`POST/PUT/DELETE /accounts/units`, `POST /accounts/units/clone`
Unit API Key	Acting as a specific agent	`GET /agents`, `GET/PUT /agents/tools`, `POST /chat-completion`, `POST /response`

Account API Key

The Account API Key authorizes account management operations.

Unit API Key

The Unit API Key authorizes operations for its agent.

Make your first request

Once you have a Unit API Key, call the Inference API to run a chat completion:

curl -X POST https://rei-api.reilabs.org/v1/chat-completion \
  -H "Authorization: Bearer YOUR_UNIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      { "role": "user", "content": "Hello, who are you?" }
    ]
  }'

Create an agent through the Agent API with your Account API Key:

curl -X POST https://api.reilabs.org/v1/accounts/units \
  -H "Authorization: Bearer YOUR_ACCOUNT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agentModel": "google/gemini-2.5-flash",
    "tag": "my-first-agent",
    "behaviourPrompt": "You are a helpful assistant."
  }'

The Agent API and Inference API references in the sidebar document each endpoint’s request and response schema.

SDK and integrations

Chat inference

Unit and agent management

Optional Rei Chat compatibility

APIs at a glance

Agent API

Account & Unit Management

Agent Operations

Inference API

Chat & Responses

Authentication

Account API Key

Unit API Key

Make your first request

​APIs at a glance

​Agent API

​Account & Unit Management

​Agent Operations

​Inference API

​Chat & Responses

​Authentication

​Account API Key

​Unit API Key

​Make your first request

APIs at a glance

Agent API

Account & Unit Management

Agent Operations

Inference API

Chat & Responses

Authentication

Account API Key

Unit API Key

Make your first request