RelviosRelvios
Core API

REST API Documentation

Integrate directly with Relvios using our standard REST API. Authenticate using Workspace API keys and interact with your unified inbox programmatically.

Authentication

All API requests require a Workspace API key. You can generate these from the API settings page in your dashboard. Pass the key via the Authorization header:

Header: Authorization: Bearer YOUR_API_KEY

Base URL

All API endpoints are prefixed with the following base URL:

https://api.relvios.com/api/workspaces/YOUR_WORKSPACE_ID/inbox

Endpoints

GET/threads

List all inbox threads for your workspace. You can filter by source, status, priority, or search query.

Query Parameters

  • status (new, open, resolved, archived)
  • source (gmail, outlook, email, slack, discord, whatsapp, instagram, messenger, telegram, webhook)
  • priority (low, medium, high)
GET/threads/:threadId

Retrieve a single thread with its entire message history and internal notes.

POST/threads/:threadId/reply

Send a direct outbound reply to a thread.

Body (JSON)

{ "bodyText": "Your reply message goes here." }
GET/messages/new?since=ISO_DATE

Fetch new messages across all threads since a specific date/time. Useful for polling and listening for incoming messages.

GEThttps://api.relvios.com/api/workspaces/admin

List all workspaces (ID and name) where the authenticated user is an admin or owner. Note: This endpoint does not use the inbox base URL.