POST /v1/analyses/{id}/feedback

Records an accuracy rating for a complete analysis. The rating shows up in the team's quality metrics and in similar-incident match weighting.

Authentication

API key with analysis:read permission.

Endpoint

POST /v1/analyses/{id}/feedback

Path parameters

Param	Type	Notes
`id`	UUID	The analysis id

Request body

Field	Type	Required	Notes
`accuracy`	`'correct' \| 'partially_correct' \| 'incorrect'`	✓	The rating
`comment`	string (≤ 5000 chars)	—	Free-form note explaining the rating

{
  "accuracy": "correct",
  "comment": "Root cause was right; pool ceiling was the fix."
}

Response

200 OK

{
  "success": true,
  "data": {
    "id": "fbk_a1b2...",
    "analysisId": "ana_x1y2...",
    "accuracy": "correct",
    "comment": "Root cause was right; pool ceiling was the fix.",
    "recordedAt": "2026-04-25T15:00:00Z"
  }
}

Error responses

Status	`error.code`	When
400	`VALIDATION_ERROR`	`id` is not a UUID, or `accuracy` is missing/invalid, or `comment` exceeds 5000 chars
401	`UNAUTHORIZED`	Missing or invalid API key
403	`FORBIDDEN`	Key lacks `analysis:read`
404	`NOT_FOUND`	No analysis with that id

Example

curl -X POST https://api.sigsentry.com/v1/analyses/ana_x1y2/feedback \
  -H "Authorization: Bearer ss_secret_..." \
  -H "Content-Type: application/json" \
  -d '{ "accuracy": "correct" }'

Re-rating

Calling this endpoint a second time on the same analysis overwrites the previous rating. The audit log captures the change.

Idempotency

POST /v1/analyses/{id}/feedback honors the Idempotency-Key header — see Idempotency.

POST /v1/analyses/{id}/feedback

On this page