Resume a trail's autopilot
Hand a paused autopilot back to automation. The caller becomes the accountable approver: what autopilot approves and merges from here is recorded as…
Hand a paused autopilot back to automation. The caller becomes the accountable approver: what autopilot approves and merges from here is recorded as authorized by them, so resuming needs the autopilot capability (admins have it). Resuming an autopilot that is not paused answers 409.
Resuming is a person's call: only a dashboard session or a device-auth CLI session can resume — ops keys, project admin keys and OAuth MCP calls are refused with 403. This operation is not exposed as an MCP tool.
The risk limit was too tight for a small change; raise it and give the trail back to autopilot.
Authorization
bearerSdkKey Pass an admin SDK key as Authorization: Bearer sdk_admin_…. Mint via POST /api/admin/keys with type: "admin".
In: header
Path Parameters
The trail's handle (T-12) or its id.
^(?:T-[0-9]+|[0-9a-fA-F-]{32,36})$1 <= length <= 64Header Parameters
Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://shipeasy.ai/api/admin/trails/string/autopilot/resume" \ -H "Content-Type: application/json" \ -d '{ "reason": "Freeze is over" }'{
"autopilot": {
"state": "off",
"authorizedBy": "string",
"authorizedAt": "string",
"pausedReason": "string",
"limits": {
"maxRisk": 0,
"repos": [
"string"
],
"types": [
"feature"
],
"maxFixRounds": 0,
"maxPullBacks": 0,
"maxRuns": 0
},
"runsUsed": 0
}
}{
"error": "Malformed request (bad JSON, missing project scope).",
"code": "BAD_REQUEST"
}{
"error": "Missing or invalid admin SDK key.",
"code": "UNAUTHORIZED"
}{
"error": "Key is valid but not allowed to act on this project.",
"code": "FORBIDDEN"
}{
"error": "The resource does not exist or is not visible to the caller.",
"code": "NOT_FOUND"
}{
"error": "A resource with this name already exists in the project.",
"code": "ALREADY_EXISTS"
}{
"error": "The request body failed structural (schema) validation.",
"code": "VALIDATION"
}Pause a trail's autopilot
Stop autopilot on a trail: it answers no more plan questions, approves no plan and merges nothing until a person resumes it. Whatever it already merged or…
Run the review agents
Launch the project's review agents on a change's latest push now, instead of waiting for the next push. Each agent's eval reads pending until its run…