Developer resources

API and Realtime Documentation

Complete reference for the Robots Center REST and WebSocket surfaces. HTTP endpoints are versioned under /api/v1, and realtime channel connections terminate at /socket.

v1 WS 175 endpoints WebSocket guide

New realtime transport

Robots Center now has a WebSocket layer for agents and operators.

Use short-lived socket tokens, connect to /socket, join agent, trace, replay, workspace, or approval topics, and stream lifecycle events without polling.

Phoenix channels Short-lived socket tokens Agent command delivery Trace and replay streaming

Start here

1. Mint a socket token with /api/v1/socket_tokens.
2. Connect your client to /socket with socket_token.
3. Join your topic and handle events like command.dispatch and trace.created.

Open guide Auth endpoints

2026-04 - Recently shipped

Agent security and compliance

Service-agent RBAC with security roles, async policy violation detection, SOC 2 and GDPR compliance report generation, and a dedicated /app/security dashboard with operator API.

Browse security endpoints

2026-03 - Recently shipped

Fleet management for physical robots

Robot registration, mission lifecycle, diagnostics, fleet alerts, OTA update management, and predictive maintenance are now part of the operator surface. Realtime fleet channels stream robot heartbeats, status changes, mission updates, and alert events over WebSocket.

Browse Operator - Fleet

2026-03 - Recently shipped

Realtime channels and WebSockets

Service agents can now mint short-lived socket tokens, connect to /socket, join Phoenix channels, receive commands, and stream trace, replay, and approval lifecycle updates in realtime.

Open WebSocket guide

2026-02 - Recently shipped

SCIM 2.0 enterprise provisioning

Full SCIM 2.0 support for enterprise identity provisioning. User and group CRUD, filtering, pagination, and idempotent upsert via externalId. Compatible with Okta, Azure AD, and other identity providers.

Browse SCIM v2

2026-02 - Recently shipped

Gateway execute with trace recording

New POST /api/v1/gateway/execute endpoint provides unified action execution with full trace event recording. Returns detailed SMTP events (connecting, authenticated, sent) and persists traces for UI observability.

Browse Gateway

2026-02 - Recently shipped

Webhook delivery system

Outbound webhook subscriptions with HMAC-SHA256 signed deliveries, exponential backoff retry (up to 8 attempts), and delivery status tracking. Subscribe to 20+ event types or use the wildcard for all events.

Browse Operator - Webhooks

2026-01 - Recently shipped

Primary workspace API key

Protected public APIs now accept the primary workspace API key directly. POST /api/v1/register returns a ready-to-use key, and POST /api/v1/agent_tokens remains optional for clients that still want short-lived tokens.

Browse Authentication

2026-01 - Recently shipped

Policy packaging and secrets depth

Managed secret APIs, policy template packs, and richer connector catalog metadata are now part of the operator surface.

Browse Operator - Gateway

2025-12 - Recently shipped

Observability search and correlation

Cross-surface search and related-record correlation endpoints now expose traces, alerts, replays, and failure groups through one operator query layer.

Browse Operator - Observability

2025-12 - Recently shipped

Evals review and incident learning

Eval review queues, incident-generated eval drafts, promotion flows, and shadow-run request fields are now documented below.

Browse Operator - Evals