Build World

curl --request POST \ --url https://api.continuouslabs.ai/v1/worlds \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "simulators": [ "smr_01J8Z5X4K7M2N9P0Q1R2S3T4V5" ] } '

{ "active_advance_id": null, "active_change_id": null, "build": { "last_submission": "rejected", "last_tool": "test", "model": "claude-fable-5-1", "phase": "finalize", "stage": "generating", "submissions": 1, "summary": null, "tool_calls": 7 }, "created_at": "2026-01-15T12:00:00Z", "current_time": "2024-01-01T00:00:00Z", "error": null, "id": "wld_01J8Z5X4K7M2N9P0Q1R2S3T4V7", "instructions": "Use stable example data for each Simulator.", "metadata": { "customer_id": "cust_123" }, "name": "open-orders", "simulations": [], "simulators": [ "smr_01J8Z5X4K7M2N9P0Q1R2S3T4V5" ], "start_time": "2024-01-01T00:00:00Z", "status": "building" }

Authorizations

Authorization

string

header

required

Use a Continuous API key. Send it in the Authorization header as a Bearer token.

Body

application/json

simulators

string[]

required

Simulator IDs for the World.

Minimum array length: 1

Pattern: ^smr_[0-9A-HJKMNP-TV-Z]{26}$

instructions

string

Describe the initial data, scenario, and relationships. Populated Worlds support up to 8 selected Simulators and 1,000 starting records in total. Named record types replace their default data. At most 16,384 characters and 65,536 UTF-8 bytes. U+0000 is not permitted.

Maximum string length: 16384

metadata

any

Customer JSON metadata, up to 16 KiB and 64 nesting levels. Returned by build, get, and list. Omission uses null.

model

enum<string>

default:claude-opus-5-5

Model that builds and reviews starting data. Defaults to claude-opus-5-5. Its provider is derived from the model.

Available options:

gpt-6-astra,

gpt-6.1-sol,

claude-opus-5-5,

claude-fable-5-1

name

string

Name for the World. Omission generates a name. The ID stays its identity, and names need not be unique.

Maximum string length: 128

start_time

string<date-time>

Simulated time the World starts at, in RFC 3339 format. Omission uses 2024-01-01T00:00:00Z. Saved starting data keeps its build dates.

timeout_seconds

integer<int64>

default:14400

Time limit for generation and validation in seconds, from 1 to 72000. Defaults to 14400 (four hours). Excludes queue wait and finalization. Retries share the same deadline.

Required range: 1 <= x <= 72000

Response

Accepted

active_advance_id

string | null

required

Current clock advance operation ID, or null.

Pattern: ^adv_[0-9A-HJKMNP-TV-Z]{26}$

active_change_id

string | null

required

Current membership change ID, or null.

Pattern: ^wch_[0-9A-HJKMNP-TV-Z]{26}$

build

object | null

required

The build's latest progress report and verified starting data, or null before the first report.

Show child attributes

created_at

string<date-time>

required

World creation time.

current_time

string<date-time>

required

Target of the last settled World clock request. Individual member clocks can differ.

error

object | null

required

Safe failure information, or null when no failure exists.

Show child attributes

string

required

World ID.

Pattern: ^wld_[0-9A-HJKMNP-TV-Z]{26}$

instructions

string

required

Instructions for the initial synthetic data and relationships, or empty when none were given.

metadata

any

required

Customer JSON metadata, or null.

name

string

required

World name. The ID is its identity, and names need not be unique.

Maximum string length: 128

simulations

object[]

required

Created member Simulations. This list is empty before first start.

Show child attributes

simulators

string[]

required

Simulator IDs in member order.

Pattern: ^smr_[0-9A-HJKMNP-TV-Z]{26}$

start_time

string<date-time>

required

Simulated time the World starts at: chosen at build, and changeable on the first Start.

status

enum<string>

required

pending while waiting for capacity; building while the build runs; ready when it can be started; running or stopped once its Simulations exist; failed when building or first start fails; canceled when the build was canceled.

Available options:

pending,

building,

ready,

running,

stopped,

failed,

canceled

Using the API

Simulators

Simulations

Worlds

Credentials

Authorizations

Body

Response