This API is unstable. Endpoints, request/response shapes, and
authentication requirements may change without notice. Do not build
production integrations against these endpoints without contacting the
Omnara team first.
Overview
The Omnara API is a RESTful JSON API served over HTTPS. All endpoints are
prefixed with /api/v1 and require authentication via a Bearer token in
the Authorization header.
Authentication
Most endpoints require a valid Bearer token. You can obtain one by
creating a Personal Access Token (PAT) in the Omnara dashboard, or by
using the CLI authentication flow.
curl -H "Authorization: Bearer <your-token>" \
https://api.omnara.com/api/v1/machines
Base URL
| Environment | URL |
|---|
| Production | https://api.omnara.com |
| Local development | http://localhost:8000 |
Endpoint groups
| Group | Description |
|---|
| Auth | Personal access tokens, user profiles |
| Relay | Relay instance registration and token refresh |
| Settings | User notification preferences |
| Sessions | User session lifecycle and chat messages |
| Machines | Register and list connected machines |
| Workspaces | Manage workspaces and launch sessions |
| Worktrees | Git worktree management and migration |
