Users

Restore a stopped item

Turns one stopped item back on — re-enables the schedule trigger, or resumes the orchestration run or workflow task — and stops listing it. An item that is no longer stopped (resumed already, finished or deleted) is marked restored too.

Refused with 409 stop_ceiling_closed while a ceiling is still closed, naming it in details.blocked_by, and with 409 stop_not_restorable for a cancelled eval run, which can only be dismissed.

post/v1/users/me/stops/{stop_id}/restore

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/users/me/stops/{stop_id}/restore
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Path parameters

stop_idstring required

The stop's ID (sst_ prefix).

Response

The restored stop.

idstring required
project_idstring required
kind'schedule_trigger' | 'eval_run' | 'orchestration_run' | 'workflow_task' | 'playbook_case' required

What was stopped: a schedule trigger is disabled, an eval run cancelled, an orchestration run, a workflow task's automation or a playbook case's cascade paused.

resource_idstring required

The stopped trigger, eval run, orchestration run, task or playbook case.

reason'debt' | 'run_allowance' | 'marketplace_fee' required

The ceiling that stopped it: a credit balance below zero, a Free plan's runs for the month used up, or marketplace fees beyond purchased credit (paid_balance_usd below zero).

restorableboolean required

False for a cancelled eval run, which can only be dismissed.

stopped_atstring date-time required
resolution'restored' | 'dismissed' nullable required
resolved_atstring date-time nullable required

Example response

{
  "id": "sst_V1StGXR8Z5jdHi6B",
  "project_id": "proj_V1StGXR8Z5jdHi6B",
  "resource_id": "trg_V1StGXR8Z5jdHi6B"
}

Changes