Pistis
API referenceFlows

List a flow's runs

GET
/flows/{flowId}/runs

The newest 50, newest first.

Authorization

bearer
headerAuthorizationBearer <token>

An API token

Path Parameters

flowId*string

A flow id

Response Body

Runs

application/json
  1. response
items*array<>
Example Request
curl -X GET 'http://127.0.0.1:7777/flows/nightly-check/runs'
Example Response
{  "items": [    {      "runId": "string",      "flowId": "string",      "sessionId": "string",      "status": "running",      "startedAt": 0,      "children": {        "property1": {          "state": "running",          "sessionId": "string"        },        "property2": {          "state": "running",          "sessionId": "string"        }      }    }  ]}

Build or change a flow PUT

Admins only, with a person's token, saved as that person (listed as `saved`). The next run takes the new steps; a run already going keeps its own. An agent proposes one with its `save_flow` tool: a waiting approval whose approval (`POST /sessions/{id}/approvals/{key}`, by someone who may build flows) saves it.

Start a flow run POST

The same `runId` returns the same run. Follow the run's session like any other.