Pistis
API referenceChanging a session

Pause the agent

POST
/sessions/{id}/pause

The step running finishes (a tool call is never cut off) and no further step starts until someone resumes; messages sent meanwhile wait. Kept across restarts. Pausing a paused session changes nothing. The owner, a collaborator, or whoever may manage sessions may.

Authorization

bearer
headerAuthorizationBearer <token>

An API token

Path Parameters

id*string

A session id

Response Body

Paused

application/json
  1. response
paused*unknown
Example Request
curl -X POST 'http://127.0.0.1:7777/sessions/ses_6c1f2a0b9d3e4f5a6b7c/pause'
Example Response
{  "paused": false}

Retry steps stopped after repeated crashes POST

Runs the session's stopped steps again. A tool call a crash cut off while it ran is reported as outcome unknown and never run again; one that waited for approval waits again. The session's owner or an admin may.

Resume the agent DELETE

The agent goes on where it stopped, then takes the messages that waited.