Build.
Integrate.
Automate.

REST API, CLI, and device authentication — all in one platform.

REST API

Every resource. One API.

Agents, engines, workflows, events, and chat sessions — all accessible over HTTP with token auth.

CLI

Install the CLI, authenticate via device code, and run workflows or stream logs from any shell.

Get CLI →

Device Auth

Device code flow lets scripts and CI runners authenticate without browser interaction or stored passwords.

Agents

Create, read, update, and list agents. Configure goals, constraints, tone, and feature flags per agent.

Engines

Package agents and workflows into runnable engines. List, run, and inspect engine state via API.

Workflows

Trigger workflow runs, poll status, and retrieve step output. Supports idempotency keys for safe retries.

Chat

Chat Sessions

Create sessions, post messages, and stream Rico responses. Multi-turn conversations tied to agents or engines.

Step 1

Request Code

POST /api/v1/device_codes — returns a short code and verification URL for the user to open.

Step 2

User Confirms

User visits the verification URL and approves the pairing. No credentials leave the browser.

Step 3

Poll for Token

GET /api/v1/device_codes/:id/poll — returns an access token once approved. Use it as a Bearer token on all requests.