Skip to main content
Starts an asynchronous World build from ready Simulators and returns it in the pending state. Builds start in queue order when workspace capacity is available. Instructions generate and validate initial synthetic data. Start the World once it is ready to create its Simulations.

​
Examples

​
Flags

​
string
Request body as JSON (alternative to individual flags). Can also be provided via stdin.
​
string
Legacy provider selection. Alone it selects the provider’s default model (openai is gpt-6-astra, claude is claude-fable-5-1); with model it must name the model’s provider. (options: openai, claude)
​
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.
​
string
default:"gpt-6-astra"
Model that builds and reviews starting data. Defaults to gpt-6-astra. Its provider is derived from the model. (options: gpt-6-astra, gpt-6-sol, claude-opus-5-5, claude-fable-5-1)
​
string
Name for the World. Omission generates a name. The ID stays its identity, and names need not be unique.
​
stringArray
required
Simulator IDs for the World.
​
string
Simulated time the World starts at, in RFC 3339 format. Omission uses 2024-01-01T00:00:00Z. Saved starting data keeps its build dates.
​
int
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.
Global flags apply to every command. See Global flags.