Attribute an item to a trail
Record that an error, alert or bug was caused by the trail after it merged. Errors carry no release or commit SHA, so attribution is a judgement: compare…
Record that an error, alert or bug was caused by the trail after it merged. Errors carry no release or commit SHA, so attribution is a judgement: compare the stack frames and the error's subject against each candidate trail's changed files (trails get --files) and resources, and attribute only on concrete evidence — a frame in a changed file, the failing call touching a resource of the trail, or a guard metric of the trail. If nothing fits, leave the item unattributed.
confidence: highormediumputs the item on the trail with sourcepost_merge, and writesevidenceas an investigation note on the item and a system comment on the trail.confidence: lowrecords a suspect instead: the trail lists it under suspected regressions and a person confirms or rejects it.
Attribution never flips a rollback. Propose one to a person as a structured question.
Safe for the restricted ops key.
A new error's stack frame sits in a file T-12 changed two hours ago; the investigating agent attributes it with the frame as evidence.
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/attributions" \ -H "Content-Type: application/json" \ -d '{ "item": "57", "confidence": "high", "evidence": "The failing frame is src/webhooks/retry.ts:88, changed by T-12 two hours before the first occurrence" }'{
"attached": true,
"item": {
"item": {
"id": "string",
"number": 0,
"type": "bug",
"title": "string",
"status": "open"
},
"priority": "nice_to_have",
"discoveredSource": "origin",
"discoveredSha": "string",
"change": {
"id": "string",
"prUrl": "string",
"prNumber": 0,
"repo": "string"
},
"milestoneId": "string",
"workKind": "code"
},
"suspect": {
"id": "string",
"item": {
"id": "string",
"number": 0,
"type": "bug",
"title": "string",
"status": "open"
},
"confidence": "high",
"evidence": "string",
"status": "pending",
"attributedBy": "string",
"source": "post_merge",
"createdAt": "string"
}
}{
"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"
}Remove a milestone from a trail
Remove a milestone. Its items stay on the trail, in no milestone; the milestones after it move up one. Nothing else on the trail changes.
Confirm a suspected regression
Confirm a suspect: the item goes onto the trail with source post_merge and the suspect's evidence is kept. A person's call — the restricted ops key cannot…