API Reference

REST API Reference

All endpoints for the Marvox backend (FastAPI on Railway). Base URL: https://your-railway-domain

Authentication Overview

JWT Bearer Token

Returned by /api/auth/login or /api/auth/register. Pass in every protected request:

Authorization: Bearer <token>

API Key (Long-Lived)NEW

Create long-lived API keys via POST /api/billing/api-keys. Use exactly like a JWT token:

Authorization: Bearer mrvx_...

Error Response Shapes

// Simple Auth Error { "detail": "Not authenticated" }

// Structured CharacterOS Error { "detail": { "error_code": "CANON_RETRIEVAL_FAILED", "message": "Vector DB unreachable", "recovery_suggestions": [...] } }

Demo login (no credentials required)

Get current user info

Delete account and owned projects

Invalidate current session

Execute robotic task with persona

Retrieve persona profile details

Update behavior policy guidelines

Retrieve fleet group consensus state

List pre-built character templates

Get a single template configuration

Instantiate a persona from a template

Retrieve audiobook production manifest

Synthesize chapter audiobook stream

Export fully compiled audiobook chapter assets

Retrieve combined analysis overview results

Retrieve extracted narrative plot points and arcs

Retrieve thematic indices and extracted concepts

Retrieve stylistic profiles and readability metrics

Start a real-time collaborative scene session

Resolve a narrative canon conflict

List duplicate character candidates for entity merge

Establish WebSocket collaborative stream

List all projects for the user

Upload manuscript and create a project

Get full project details

Delete project and associated data

Manually trigger CharacterOS build

Chat with a canon-locked character

List all character profiles

Get a single character profile

Generate a multi-character scene

Ask a story Q&A question (RAG)

Trigger character memory reflection

Generate scene audio pipeline

List available voice configurations

Configure character voice profiles

Poll job status and progress

Create a long-lived API key

List active API keys (prefixes only)

Revoke an API key

Stripe Webhook Receiver

Transcribe a voice or audio input into text

Standalone transcription (no project scope)

List saved voice recipes

Create a voice recipe

Update a voice recipe

Delete a voice recipe

Resolve a shared voice recipe by token

Export storyworld data in a production format

Create an export with an audit trail

Retrieve the export audit log

Loading…

REST API Reference

Authentication Overview

Authentication

Robotics Persona API

Character App Store

Audiobook Production

Advanced Storyworld Analysis

Real-time Collaboration

Projects

CharacterOS

Audio & Voice

Background Jobs

Billing & API Keys

Transcription

Voice Recipes

Export Formats

REST API Reference

Authentication Overview

Authentication

Robotics Persona API

Character App Store

Audiobook Production

Advanced Storyworld Analysis

Real-time Collaboration

Projects

CharacterOS

Audio & Voice

Background Jobs

Billing & API Keys

Transcription

Voice Recipes

Export Formats