API reference / Workflows / Every paused step for an app

Every paused step for an app

GET/apps/{appId}/paused-steps

Authenticate with an operator token or an app API key or a signed-in Foliot Console session.

Path parameters

appId

string

REQUIRED

The app's name.

Responses

200 object OK

401 Error Missing, malformed or unknown bearer token.

403 Error The token is valid but not permitted on this route.

404 Error No such resource.

503 Error A dependency this route needs is unreachable.

cURL

curl "https://api.foliot.app/apps/{appId}/paused-steps" \
  -H "Authorization: Bearer $FOLIOT_TOKEN"

RESPONSE 200 OK

{
  "paused": [
    {
      "actor": null,
      "appId": "string",
      "paused": true,
      "reason": null,
      "step": "string",
      "updatedAt": "2026-10-01T09:30:00Z",
      "workflowName": "string"
    }
  ]
}