Pistis
API referenceChanging a session

Retry steps stopped after repeated crashes

POST
/sessions/{id}/parked/retry

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.

Authorization

bearer
headerAuthorizationBearer <token>

An API token

Path Parameters

id*string

A session id

Response Body

Retried

application/json
  1. response
retried*integer

How many steps run again (0 when none was stopped)

Example Request
curl -X POST 'http://127.0.0.1:7777/sessions/ses_6c1f2a0b9d3e4f5a6b7c/parked/retry'
Example Response
{  "retried": 0}

List steps stopped after repeated crashes GET

Steps the server stopped running because a crash cut them off five times in a row. They wait until someone retries them. Empty when nothing is stopped.

Pause the agent POST

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.