Skip to main content
GET
Get a campaign (spine + authored chapters)

Authorizations

Authorization
string
header
required

An app API key, e.g. Authorization: Bearer sk_live_…. Secret (sk_) for writes/sessions; publishable (pk_) is read-only (browser-safe).

Path Parameters

id
string<uuid>
required

Response

The campaign resource (spine + chapters authored so far)

A multi-chapter book→game campaign: one story spine plus the chapter worlds authored from it. Each chapter is an ordinary playable world (run it via POST /v1/sessions/token like any other). worlds lists the chapters authored SO FAR, ordered by actIndex, so the list grows while the generation job runs. Tenant-scoped: only the app that created it can read it.

id
string<uuid>
required
fidelity
enum<string>
required

How closely the chapters track the source text (echoes the create request).

Available options:
faithful,
spirit
actCount
integer
required

Total chapters the spine defines (0 until the spine stage completes). worlds.length reaches this when the job succeeds.

worlds
object[]
required

Chapters authored so far, ordered by actIndex. Each is a standalone world.

title
string | null

Campaign title (from the book bible; defaults to the request name).

logline
string | null

One-line premise distilled from the source text.

cover
string | null

Cover image URL (the first chapter's seed, once painted).

graph
object | null

The story-spine graph (acts + how they connect). {} until the spine stage completes.

schemaVersion
string
Example:

"1.0"