Pause a project
POST/v1/projects/:project_id/pause
Stops everything the project runs, with one call. From the moment it answers, nothing new starts: generations, tool calls, orchestration runs, eval runs and trigger fires in the project respond 409 with PROJECT_PAUSED, and so does resuming a single run or task the pause holds. A channel keeps receiving messages and answers each with a neutral "can't reply right now" line.
What is already in motion is parked, not discarded: live orchestration runs pause at their next checkpoint, open tasks stop dispatching, schedule triggers stop firing and queued eval items wait. A generation already running finishes. Reads and configuration changes keep working.
Idempotent: pausing a paused project answers it unchanged and keeps the first reason. Emits project.paused. Requires the admin role.
Request
Responses
- 200
- 400
- 401
- 403
- 404
The paused project.
The request was malformed or failed validation.
Missing or invalid credentials.
The credential is scoped to a different project, or the caller's role in the project does not carry this action.
The resource does not exist (existence is not leaked).