---
title: "List retained Triage history"
method: GET
path: "/v1/triage/changes/{id}/history"
tags: ["Triage"]
---

# List retained Triage history

`GET /v1/triage/changes/{id}/history`

## Request

- Base URL: `https://api.coderabbit.ai`
- URL: `https://api.coderabbit.ai/v1/triage/changes/{id}/history`
- Auth: API key in header `x-coderabbitai-api-key`

## Path parameters

- `id` string, required

## Query parameters

- `org_id` string
- `limit` integer
- `cursor` string
- `type` 'all' | 'priority' | 'close_candidacy'

## Response `200`

Successful read, including an empty collection or unknown optional assessments.

- TriageHistory
  - `data` union[], required
    - union
      - object
        - `id` string, required
        - `occurred_at` string, date-time, required
        - `source` 'calculated' | 'manual', required
        - `actor` union, required
          - object
            - `id` string, required
            - `identity_type` 'coderabbit', required
            - `name` union, required
              - …
          - unknown
        - `reason` union, required
          - string
          - unknown
        - `type` 'priority', required
        - `previous_value` union, required
          - 'p0' | 'p1' | 'p2' | 'p3' | 'none'
          - unknown
        - `new_value` 'p0' | 'p1' | 'p2' | 'p3' | 'none', required
      - object
        - `id` string, required
        - `occurred_at` string, date-time, required
        - `source` 'calculated' | 'manual', required
        - `actor` union, required
          - object
            - `id` string, required
            - `identity_type` 'coderabbit', required
            - `name` union, required
              - …
          - unknown
        - `reason` union, required
          - string
          - unknown
        - `type` 'close_candidacy', required
        - `previous_value` union, required
          - boolean
          - unknown
        - `new_value` boolean, required
  - `next_cursor` union, required
    - string
    - unknown
  - `meta` object, required
    - `request_id` string, required
    - `org_id` string, required
    - `generated_at` string, date-time, required
    - `total_count` integer, required
    - `limit` integer, required
    - `change_id` string, required
    - `type` 'all' | 'priority' | 'close_candidacy', required
    - `history_complete` union, required
      - boolean
      - unknown

## Other responses

- `400`: invalid_parameter, unknown_parameter, duplicate_parameter, invalid_id, missing_org_id, missing_team_id, unexpected_team_id, invalid_grouping, request_body_not_allowed, unsupported_history_type, cursor_invalid, cursor_expired, cursor_mismatch
- `401`: authentication_required, invalid_api_key
- `403`: viewer_identity_required, org_access_denied, triage_access_denied, capability_unavailable
- `404`: change_not_found, team_not_found, route_not_found
- `406`: not_acceptable
- `429`: rate_limit_exceeded
- `500`: internal_error
- `502`: upstream_bad_response
- `503`: service_unavailable, dependency_unavailable, provider_connection_unavailable
- `504`: upstream_timeout

## Changes

- **2026-11-06** `a9e20f8748a9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/coderabbit/apis/coderabbit-api-spec/changes/v1/triage/changes/:id/history/get.md)

---

[API](https://skmtc.dev/coderabbit/apis/coderabbit-api-spec.md) - [All operations](https://skmtc.dev/coderabbit/apis/coderabbit-api-spec/llms.txt) - [OpenAPI document](https://skmtc.dev/coderabbit/apis/coderabbit-api-spec/revisions/a9e20f8748a9?raw)