# continuous-simulation API

> Build and run simulated systems for AI agents.

- [List Simulations in the workspace](https://docs.continuouslabs.ai/api-reference/simulations/list-simulations-in-the-workspace.md): Lists workspace Simulations with status and Simulator filters. Results use cursor pagination.
- [Create a Simulation of a ready Simulator](https://docs.continuouslabs.ai/api-reference/simulations/create-a-simulation-of-a-ready-simulator.md): Starts a ready Simulator as an isolated Simulation. The response includes its data-plane endpoint and one-time access token.
- [Fetch a Simulation's status, config, and endpoint](https://docs.continuouslabs.ai/api-reference/simulations/fetch-a-simulations-status-config-and-endpoint.md): Returns the Simulation lifecycle, configuration, endpoint, and labels. It never returns the data-plane token.
- [Delete a Simulation (removes it entirely)](https://docs.continuouslabs.ai/api-reference/simulations/delete-a-simulation-removes-it-entirely.md): Deletes a Simulation and its saved runtime state. Stop dependent use before deletion.
- [Stream Simulation events](https://docs.continuouslabs.ai/api-reference/simulations/stream-simulation-events.md): Streams current Simulation status and new step events as server-sent events.
- [Fork a running Simulation at head or at a step](https://docs.continuouslabs.ai/api-reference/simulations/fork-a-running-simulation-at-head-or-at-a-step.md): Creates a new Simulation from the current head or a recorded step. The source Simulation keeps running.
- [Start a stopped Simulation from its frozen state](https://docs.continuouslabs.ai/api-reference/simulations/start-a-stopped-simulation-from-its-frozen-state.md): Restarts a stopped Simulation from its frozen state. The data-plane endpoint becomes available when the start completes.
- [List a Simulation's step registry](https://docs.continuouslabs.ai/api-reference/simulations/list-a-simulations-step-registry.md): Lists stable step records for a running Simulation. Use a step number to create a deterministic fork.
- [Stop a running Simulation (freeze its state; restartable)](https://docs.continuouslabs.ai/api-reference/simulations/stop-a-running-simulation-freeze-its-state;-restartable.md): Freezes and stops a running Simulation. You can restart it later without losing its state.
- [Re-mint a serving Simulation's data-plane token](https://docs.continuouslabs.ai/api-reference/simulations/re-mint-a-serving-simulations-data-plane-token.md): Rotates the data-plane token for a running or paused Simulation. The previous token stops working immediately. This operation requires a sealed user session.
- [List Simulators (includes the pre-baked catalog)](https://docs.continuouslabs.ai/api-reference/simulators/list-simulators-includes-the-pre-baked-catalog.md): Lists workspace Simulators and the shared catalog. Filter by status or name and use cursor pagination.
- [Build a Simulator from a system spec](https://docs.continuouslabs.ai/api-reference/simulators/build-a-simulator-from-a-system-spec.md): Starts an asynchronous build from an OpenAPI or WSDL source. Use the returned Simulator ID to read build status and events.
- [Publish an uploaded Simulator](https://docs.continuouslabs.ai/api-reference/simulators/publish-an-uploaded-simulator.md): Publishes an uploaded Simulator artifact into the workspace. Use an upload created for the simulator_artifact purpose.
- [Fetch a Simulator's status and lineage](https://docs.continuouslabs.ai/api-reference/simulators/fetch-a-simulators-status-and-lineage.md): Returns the Simulator build status, lineage, tags, and artifact identity.
- [Delete an unreferenced Simulator](https://docs.continuouslabs.ai/api-reference/simulators/delete-an-unreferenced-simulator.md): Deletes a Simulator that has no child Simulators or dependent Simulations.
- [Fetch a Simulator's build model](https://docs.continuouslabs.ai/api-reference/simulators/fetch-a-simulators-build-model.md): Returns the generated model that defines the Simulator entities, operations, state rules, and tests.
- [Cancel an in-flight Simulator build](https://docs.continuouslabs.ai/api-reference/simulators/cancel-an-in-flight-simulator-build.md): Requests cancellation for a Simulator that is still building. Read the Simulator resource or event stream for the final status.
- [Stream Simulator events](https://docs.continuouslabs.ai/api-reference/simulators/stream-simulator-events.md): Streams Simulator build progress as server-sent events until the build reaches a terminal status.
- [Fetch a Simulator's OpenAPI document](https://docs.continuouslabs.ai/api-reference/simulators/fetch-a-simulators-openapi-document.md): Returns the OpenAPI document that the Simulator implements at runtime.
- [Point a name:tag at a Simulator](https://docs.continuouslabs.ai/api-reference/simulators/point-a-name:tag-at-a-simulator.md): Points a name and tag reference at a ready Simulator. Use a reference such as billing:latest.
- [Remove a Simulator tag](https://docs.continuouslabs.ai/api-reference/simulators/remove-a-simulator-tag.md): Removes a name and tag reference from a Simulator. The Simulator artifact remains available by ID.
- [Fetch SOAP request contracts from a Simulator's WSDL](https://docs.continuouslabs.ai/api-reference/simulators/fetch-soap-request-contracts-from-a-simulators-wsdl.md): Returns the normalized SOAP request contracts generated from the Simulator's WSDL source.
- [Create an authenticated upload](https://docs.continuouslabs.ai/api-reference/uploads/create-an-authenticated-upload.md): Creates a signed upload for one Simulator artifact. Send the bytes to the returned URL before it expires.
- [Server build version](https://docs.continuouslabs.ai/api-reference/meta/server-build-version.md): Returns the server build version. This value is separate from the stable v1 API contract.
- [List Worlds in the workspace](https://docs.continuouslabs.ai/api-reference/worlds/list-worlds-in-the-workspace.md): Lists workspace Worlds with cursor pagination.
- [Create a World that brings up a set of Simulations together](https://docs.continuouslabs.ai/api-reference/worlds/create-a-world-that-brings-up-a-set-of-simulations-together.md): Creates a World from named Simulator references. Continuous starts one Simulation for each member and returns the coordinated service map.
- [Fetch a World's status and service map](https://docs.continuouslabs.ai/api-reference/worlds/fetch-a-worlds-status-and-service-map.md): Returns the World lifecycle, member statuses, and named service endpoints.
- [Delete a World (tears down its member Simulations)](https://docs.continuouslabs.ai/api-reference/worlds/delete-a-world-tears-down-its-member-simulations.md): Deletes a World and tears down its member Simulations.
- [Start a World (restarts all its member Simulations from their snapshots)](https://docs.continuouslabs.ai/api-reference/worlds/start-a-world-restarts-all-its-member-simulations-from-their-snapshots.md): Restarts every stopped member Simulation from its saved snapshot.
- [Stop a World (freezes and stops all its member Simulations)](https://docs.continuouslabs.ai/api-reference/worlds/stop-a-world-freezes-and-stops-all-its-member-simulations.md): Freezes and stops every running member Simulation. You can restart the World later.

## OpenAPI Specs

- [simulation](/openapi/simulation.yaml)