Decrees

Decrees are external interventions injected into a running simulation. They allow you to model policy changes, sudden events, or any exogenous shock that alters the simulation’s trajectory mid-run.

All decree endpoints require authentication.

Submit Decree

POST /v1/simulations/{id}/decrees

Submits a decree to an active simulation. The decree is applied at the next simulation tick.

Scope required: simulation:write

Path Parameters

Parameter	Type	Description
id	uuid	Simulation ID

Request Body

Field	Type	Required	Description
type	string	Yes	Decree type identifier
payload	object	Yes	Decree-specific payload

Response 201

{
  "id": "d1e2f3a4-...",
  "simulationId": "a1b2c3d4-...",
  "type": "capability_jump",
  "payload": {
    "target": "frontier_model",
    "magnitude": 0.4
  },
  "createdAt": "2025-06-15T10:35:00.000Z"
}

Example

curl -X POST https://api.anankelabs.ai/v1/simulations/a1b2c3d4-.../decrees \
  -H "X-Api-Key: krs_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "capability_jump",
    "payload": {"target": "frontier_model", "magnitude": 0.4}
  }'

List Decrees

GET /v1/simulations/{id}/decrees

Returns a paginated list of all decrees submitted to a simulation.

Scope required: simulation:read

Path Parameters

Parameter	Type	Description
id	uuid	Simulation ID

Query Parameters

Parameter	Type	Default	Description
limit	integer	50	Results per page (1–200)
offset	integer	0	Pagination offset
order	string	"asc"	Sort order: "asc" or "desc"

Response

{
  "data": [
    {
      "id": "d1e2f3a4-...",
      "simulationId": "a1b2c3d4-...",
      "type": "capability_jump",
      "payload": {
        "target": "frontier_model",
        "magnitude": 0.4
      },
      "createdAt": "2025-06-15T10:35:00.000Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 3
  }
}

Example

curl "https://api.anankelabs.ai/v1/simulations/a1b2c3d4-.../decrees?order=desc" \
  -H "X-Api-Key: krs_..."