Reopen a trail
Reopen a closed trail so its changes can be reviewed and merged again. Its phase is recomputed from its changes and resources.
Reopen a closed trail so its changes can be reviewed and merged again. Its phase is recomputed from its changes and resources.
Reopening is a person's call: the restricted ops key cannot reopen a trail.
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).
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://shipeasy.ai/api/admin/trails/string/reopen"{
"id": "string",
"number": 0,
"handle": "string",
"title": "string",
"body": "string",
"type": "feature",
"priority": "nice_to_have",
"owner": {
"user": {
"id": "string",
"email": "string",
"name": "string"
},
"agent": {
"connectorId": "string",
"builtin": "jarvis",
"provider": "claude_trigger",
"name": "string"
}
},
"status": "open",
"closedReason": "string",
"phase": "planning",
"phaseReason": "string",
"origin": {
"id": "string",
"number": 0,
"type": "bug",
"title": "string",
"status": "open"
},
"repos": [
"string"
],
"changesOpen": 0,
"changesMergeable": 0,
"findingsOpenHigh": 0,
"itemsOpen": 0,
"resourcesCount": 0,
"startDate": "2019-08-24",
"targetDate": "2019-08-24",
"health": "on_track",
"healthSource": "person",
"itemsTotal": 0,
"itemsDone": 0,
"goal": {
"metric": {
"id": "string",
"key": "string"
},
"direction": "increase",
"baseline": 0,
"target": 0,
"unit": "string"
},
"releasedPct": 0,
"mergedAt": "string",
"shippedAt": "string",
"closedAt": "string",
"snapshotAt": "string",
"createdAt": "string",
"updatedAt": "string"
}{
"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"
}Close a trail
Close a trail by hand — abandoned, superseded, or shipped with discovered items still open. A trail also closes on its own once it is shipped with no…
Link a pull request to a trail
Link a pull request to the trail as one of its *changes*. From then on the GitHub webhook records its pushes, the project's review agents score each push,…