API Reference

REST API endpoints for event tracking, playbooks, interventions, and configuration

Complete REST API reference for Retivo. All endpoints are auto-generated from the OpenAPI spec and include request/response schemas, example payloads, and try-it-out playgrounds.

Authentication

Authorization: Bearer rt_live_...

API keys are created in Settings → API Keys. Keys starting with rt_live_ are for production, rt_test_ for testing.

Endpoints

Browse endpoints by category in the sidebar, or jump to a section:

Events

Track product events from your app

Customers

Manage tracked users and their state

Playbooks

Configure when and how Retivo intervenes

Interventions

View and manage AI-generated interventions

Escalations

Handle cases routed to human review

Analytics

Aggregated metrics and insights

Settings

Tenant configuration and admin controls

Team

Team member and invitation management

Billing

Subscription and plan management

Webhooks

Outbound webhook endpoint management

Connectors

Ingest events from Segment, PostHog, and Mixpanel

Base URL

Environment	URL
Production	`https://retivo.ai/api`
Local development	`http://localhost:3000/api`

OpenAPI Spec

The full OpenAPI 3.1 specification is available at /api/openapi.json.