REST API

Raconte exposes a REST API to manage interviews and invitations directly over HTTP. It is the same surface the MCP server drives, available to any HTTP client. Use MCP when you want an AI agent to operate the product, and the REST API when you integrate from your own backend. For terminals and scripts, reach for the CLI; for TypeScript or Node apps, the SDK.

The complete, interactive reference (every endpoint, parameter, schema, and a built-in “try it”) lives here:

Open the interactive API reference →

Base URL

https://api.raconte.ai

Every path is prefixed with /api, for example https://api.raconte.ai/api/interviews.

Authentication

Authentication uses an organization API key, created from Settings → API in the app and scoped to one organization. Every request runs against that organization; resources from other orgs are never returned.

Pass the key as a Bearer token:

Authorization: Bearer YOUR_API_KEY

An x-api-key: YOUR_API_KEY header is also accepted.

curl https://api.raconte.ai/api/interviews \
  -H "Authorization: Bearer YOUR_API_KEY"

What you can do

• Interviews: create, list, read, update, archive/restore, regenerate the intro or first message, and read activity logs.
• Invitations: create (single or bulk), list, read, update, send, cancel, reactivate, archive/restore, read logs, and get a presigned audio URL for a message.

Account-level operations (billing, webhooks, API key management, organization settings) are not available through API keys: they stay in the authenticated app.

See the interactive reference for the full request and response schemas.