Rensei docs
API ReferenceWorker Protocol

Enqueue a daemon-config mutation

Enqueues a configuration mutation for delivery to a specific daemon host on its next heartbeat. Supported ops: - `project.add` - add project to daemon allowlist - `project.remove` - remove project from allowlist - `pool.deleted` - notify daemon of a deleted resource pool - `modelAccess.set` - write a machine-scoped model-access policy - `modelAccess.clear` - clear a workload-specific access policy Requires org admin/owner role. The cancel window closes as soon as the daemon's next heartbeat stamps `deliveredAt`.

POST
/api/daemon/mutations

Authorization

rsk_Bearer
AuthorizationBearer <token>

Rensei API key. Format: rsk_live_<random>. Generated in Settings or via POST /api/org/{orgId}/keys. Used by CLI (af), daemon, and programmatic integrations.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/daemon/mutations" \  -H "Content-Type: application/json" \  -d '{    "workerHostId": "string",    "op": "project.add",    "params": {}  }'
{
  "mutation": {
    "id": "string",
    "orgId": "string",
    "workerHostId": "string",
    "op": "project.add",
    "params": {},
    "status": "pending",
    "requestedBy": "string",
    "deliveredAt": "2019-08-24T14:15:22Z",
    "cancelledAt": "2019-08-24T14:15:22Z",
    "createdAt": "2019-08-24T14:15:22Z"
  }
}
{
  "error": "Session not found"
}
{
  "error": "Session not found"
}
{
  "error": "Session not found"
}
{
  "error": "Session not found"
}

List daemon mutation history for a host

List daemon mutation history for a host - Rensei REST API operation reference.

Cancel an undelivered daemon mutation

Cancels a pending mutation before it is delivered to the daemon. Returns 409 if already delivered or terminal. Returns 404 if the mutation does not exist or does not belong to the caller's org. Once a heartbeat delivers the mutation, the only way to "undo" is to enqueue the inverse op (e.g. `project.remove` for a wrongly applied `project.add`).