Team messaging.
Actually affordable.

Create a new workspace. Provisions an isolated namespace, default channels, and an admin user. Returns the workspace object with provisioning status.

{
  "name": "acme-corp",
  "display_name": "Acme Corp",
  "plan": "starter",
  "admin_email": "tyler@acme.com",
  "region": "nyc3"
}

{
  "id": "ws_01HXYZ4RELAY",
  "name": "acme-corp",
  "plan": "starter",
  "region": "nyc3",
  "created_at": "2026-04-28T09:00:00Z",
  "status": "provisioning",
  "api_key": "rly_live_sk_...",
  "stream_url": "https://ws_01HXYZ4RELAY.relay.dev/v1/stream"
}

{
  "error": "validation_error",
  "message": "Workspace name already taken",
  "field": "name"
}

Retrieve workspace details by ID. Includes provisioning status, plan, region, and member count.

List all channels in the workspace. Supports filtering by type (public/private/dm) and membership.

Create a new channel. Public channels are discoverable by all workspace members. Private channels require explicit membership.

Join a public channel. For private channels, membership must be granted by a channel admin.

Post a message to a channel or DM thread. Supports plain text, Markdown, file attachments, and structured blocks. Message is instantly fanned out via Redis Pub/Sub to all connected subscribers.

{
  "channel_id": "ch_01HXYZ",
  "text": "Deploy summary",
  "blocks": [
    { "type": "header", "text": "v2.1 deployed successfully" },
    { "type": "section", "text": "Environment: **production**\nDuration: 42s\nStatus: ✅" },
    { "type": "actions", "elements": [
      { "type": "button", "text": "View logs", "url": "https://logs.acme.com" }
    ]}
  ]
}

Retrieve messages for a channel. Hot messages are served from SQLite. Queries spanning the archive threshold are transparently merged with Neon Postgres results.

Edit the content of an existing message. Only the message author or workspace admins may edit. Edits are recorded in the message's edit_history.

Soft-delete a message. The message is replaced with a tombstone in the channel. Permanently deleted after the workspace retention period.

Send an invitation email to a new workspace member. Generates a one-time invite token valid for 7 days.

Returns presence status for all or specified workspace members. Backed by Redis TTL keys — refreshed every 30s by connected clients.

Open a Server-Sent Events stream for the workspace. The client receives a real-time feed of all events the authenticated user is permitted to receive. Redis Pub/Sub fans out internally; clients see a clean SSE stream.

// message.created
data: {"type":"message.created","id":"evt_01H...","data":{"message":{...}}}

// typing.start / typing.stop
data: {"type":"typing.start","id":"evt_01H...","data":{"user_id":"usr_...","channel_id":"ch_..."}}

// presence.update
data: {"type":"presence.update","id":"evt_01H...","data":{"user_id":"usr_...","status":"online"}}

// ai.response (streaming token)
data: {"type":"ai.response","id":"evt_01H...","data":{"bot_id":"bot_...","token":"Hello","done":false}}

Register an AI bot or integration participant. Bots receive messages via webhook and can post back using the standard messages API. Tool schemas follow the OpenAI function-calling format.

{
  "name": "deploy-bot",
  "webhook_url": "https://your-server.com/relay-hook",
  "mention_only": true,
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_deployment_status",
        "description": "Get the current deployment status for an environment",
        "parameters": {
          "type": "object",
          "properties": {
            "environment": { "type": "string", "enum": ["production","staging","dev"] }
          },
          "required": ["environment"]
        }
      }
    }
  ]
}

Returns the OpenAI-compatible tool schema array for a registered bot. Used by AI agents to discover callable functions in a channel.

Register an outbound webhook. Relay will POST event payloads to your endpoint when specified events occur. HMAC-SHA256 signed with your webhook secret.