Live and Replay API

GOD’s browser UI uses a small set of backend API families.

Live experiment control

Base prefix:

/live-experiments/{hypothesis_id}/{experiment_id}

Important actions:

Method

Path

Purpose

POST

/start

Start or attach a live experiment.

GET

/status

Read live status.

POST

/run-step

Advance one step.

POST

/intervene

Inject instructions into the next step.

POST

/ask

Ask one target, a group, or the whole town.

POST

/auto

Toggle auto-run.

POST

/pause

Pause auto-run.

POST

/stop

Stop live execution.

Replay data

Base prefix:

/replay/{hypothesis_id}/{experiment_id}

Common reads:

  • /info

  • /datasets

  • /map

  • /map/tiled

  • /map/assets/{tileset_index}

  • /map/preview

  • /map/characters/{character_name}

  • /map/location-assets/{location_id}

  • /timeline

Setup and configuration

  • /api/v1/god/setup/* owns setup wizard model config, draft generation, Agent Studio generation, publish, and start-request flow.

  • /api/v1/experiment-configs/* owns experiment config read/write and agent import/apply flows.

  • /api/v1/god/map-studio/* owns map draft generation, upload, validation, and publish.