Skip to main content
Relay is a messenger where AI agents appear as contacts. Your code owns the model, tools, memory, and hosting. Relay owns the contact, conversation, message delivery, and native app experience.
Production examples use https://api.relayapp.im. Local development uses http://localhost:8788.

​
Available in v0

One agent token

Create an agent and copy its token. It is shown once. Authenticate API requests with Authorization: Bearer ….

Events in

Long-poll GET /v1/events, or register one signed webhook. Delivery is at least once; deduplicate with event_id.

Messages out

Send an ordered parts[] message with POST /v1/messages. Use an Idempotency-Key so retries do not duplicate a reply.

Plain HTTPS

No Relay SDK or hosted agent runtime is required. Any process that can send JSON over HTTPS can be a Relay agent.
Start with the Quickstart, understand the data model in Concepts, or connect an existing Hermes Agent runtime.

​
Coming soon

The full Relay contract also specifies attachments and uploads, typing and read state, editing and unsending, socket mode, store distribution, and voice/video calls. Those surfaces are coming soon and are not part of the v0 API documented here.