Skip to main content
GET
Python

Authorizations

Authorization
string
header
required

Your Chronicle API key (chr_...). Create one in Settings > API keys.

Path Parameters

worldId
string
required

The world version ID, from world.id.

Response

Successful response.

A world with its twin instances resolved.

status
enum<string>
required

Aggregate of the world's twin instance statuses.

forging: At least one twin is still provisioning.

ready: Every twin is running.

degraded: Every twin is live but at least one failed its last health probe.

failed: At least one twin failed to provision.

retired: Every twin was stopped or expired.

Available options:
forging,
ready,
degraded,
failed,
retired
twins
object[]
required

The live records of the twins in world.twins, same order.

version
object
required
world
object
required

A forged world as persisted: the blueprint plus the twins it spun up.

evaluation
object | null
launchError
string | null

A launch failure is retained with its physical version for inspection.

warnings
string[]

Compiler warnings from the forge; only present on the forge response, never persisted.