---
title: "List Triage changes"
method: GET
path: "/v1/triage/changes"
tags: ["Triage"]
---

# List Triage changes

`GET /v1/triage/changes`

## Request

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

## Query parameters

- `org_id` string
- `limit` integer
- `cursor` string
- `view` 'mine' | 'team'
- `team_id` string
- `repository_id` string[]
- `provider` string[]
- `priority` string[]
- `close_candidate` 'true' | 'false' | 'unknown'
- `change_type` string[]
- `blast_radius` string[]
- `merge_risk` string[]
- `focus_state` string[]
- `attention` 'all' | 'required' | 'waiting' | 'unknown'
- `group_by` 'none' | 'focus_state' | 'priority' | 'repository' | 'author'
- `subgroup_by` 'none' | 'focus_state' | 'priority' | 'repository' | 'author'
- `order_by` 'triage' | 'priority' | 'last_activity_at' | 'opened_at' | 'external_id' | 'title'
- `order_direction` 'asc' | 'desc'

## Response `200`

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

- TriageChanges
  - `data` object[], required
    - `id` string, required
    - `external_id` string, required
    - `provider` 'github' | 'gitlab' | 'bitbucket' | 'azure-devops', required
    - `provider_host` string, required
    - `url` union, required
      - string, uri
      - unknown
    - `repository` object, required
      - `id` union, required
        - string
        - unknown
      - `owner` string, required
      - `name` string, required
    - `title` union, required
      - string
      - unknown
    - `state` 'open' | 'merged' | 'closed' | 'unknown', required
    - `author` union, required
      - object
        - `id` union, required
          - string
          - unknown
        - `username` union, required
          - string
          - unknown
        - `name` union, required
          - string
          - unknown
      - unknown
    - `head_revision` union, required
      - string
      - unknown
    - `latest_commit_at` union, required
      - string, date-time
      - unknown
    - `latest_reviewable_observed_at` union, required
      - string, date-time
      - unknown
    - `opened_at` union, required
      - string, date-time
      - unknown
    - `age_seconds` union, required
      - integer
      - unknown
    - `last_activity_at` union, required
      - string, date-time
      - unknown
    - `last_human_activity_at` union, required
      - string, date-time
      - unknown
    - `change_type` union, required
      - 'bugfix' | 'feature' | 'refactor'
      - unknown
    - `focus_state` union, required
      - 'now' | 'next'
      - unknown
    - `priority` object, required
      - `level` union, required
        - 'p0' | 'p1' | 'p2' | 'p3' | 'none'
        - unknown
      - `source` union, required
        - 'calculated' | 'manual'
        - unknown
      - `reason` union, required
        - string
        - unknown
      - `reason_codes` string[], required
      - `score` union, required
        - number
        - unknown
      - `confidence` union, required
        - number
        - unknown
      - `override` union, required
        - object
          - `level` 'p0' | 'p1' | 'p2' | 'p3', required
        - unknown
    - `close_candidate` object, required
      - `value` union, required
        - boolean
        - unknown
      - `status` 'available' | 'unknown' | 'stale' | 'unsupported', required
      - `observed_at` union, required
        - string, date-time
        - unknown
      - `revision` union, required
        - string
        - unknown
      - `source` union, required
        - 'manual' | 'calculated'
        - unknown
      - `reason` union, required
        - string
        - unknown
    - `requires_attention` union, required
      - boolean
      - unknown
    - `attention_reason_codes` string[], required
    - `next_action` object, required
      - `kind` union, required
        - 'merge' | 'review' | 'find_reviewer' | 'start_review' | 'fix_checks' | 'resolve_conflicts' | 'autofix' | 'refresh_branch' | 'update_change' | 'respond' | 'decide' | 'close' | 'follow' | 'notify' | 'none'
        - unknown
      - `responsible_role` 'author' | 'reviewer' | 'maintainer' | 'system' | 'unknown', required
      - `responsible_users` object[], required
        - `id` union, required
          - string
          - unknown
        - `username` union, required
          - string
          - unknown
        - `name` union, required
          - string
          - unknown
      - `reason_codes` string[], required
      - `status` 'available' | 'unknown', required
    - `review_status` union, required
      - object
        - `status` 'available', required
        - `value` 'reviewed' | 'new_changes_since_review' | 'review_needed' | 'review_starting' | 'reviewing' | 'review_failed' | 'no_reviewable_changes', required
        - `observed_at` union, required
          - string, date-time
          - unknown
        - `revision` union, required
          - string
          - unknown
      - object
        - `status` 'unknown' | 'stale' | 'unsupported', required
        - `value` 'null', nullable, required
        - `observed_at` union, required
          - string, date-time
          - unknown
        - `revision` union, required
          - string
          - unknown
    - `approval_status` union, required
      - object
        - `status` 'available', required
        - `value` 'approved' | 'changes_requested' | 'review_required' | 'stale_approval', required
        - `observed_at` union, required
          - string, date-time
          - unknown
        - `revision` union, required
          - string
          - unknown
      - object
        - `status` 'unknown' | 'stale' | 'unsupported', required
        - `value` 'null', nullable, required
        - `observed_at` union, required
          - string, date-time
          - unknown
        - `revision` union, required
          - string
          - unknown
    - `blast_radius` union, required
      - object
        - `status` 'available', required
        - `value` 'low' | 'medium' | 'high', required
        - `observed_at` union, required
          - string, date-time
          - unknown
        - `revision` union, required
          - string
          - unknown
      - object
        - `status` 'unknown' | 'stale' | 'unsupported', required
        - `value` 'null', nullable, required
        - `observed_at` union, required
          - string, date-time
          - unknown
        - `revision` union, required
          - string
          - unknown
    - `merge_risk` union, required
      - object
        - `status` 'available', required
        - `value` object, required
          - `level` 'low' | 'medium' | 'high', required
          - `score` number, required
          - `basis` 'direct' | 'proxy' | 'mixed' | 'unknown', required
          - `reason` union, required
            - string
            - unknown
        - `observed_at` union, required
          - string, date-time
          - unknown
        - `revision` union, required
          - string
          - unknown
      - object
        - `status` 'unknown' | 'stale' | 'unsupported', required
        - `value` 'null', nullable, required
        - `observed_at` union, required
          - string, date-time
          - unknown
        - `revision` union, required
          - string
          - unknown
    - `security_risk` union, required
      - object
        - `status` 'available', required
        - `value` object, required
          - `level` 'minimal' | 'low' | 'moderate' | 'high' | 'critical', required
          - `reason` union, required
            - string
            - unknown
        - `observed_at` union, required
          - string, date-time
          - unknown
        - `revision` union, required
          - string
          - unknown
      - object
        - `status` 'unknown' | 'stale' | 'unsupported', required
        - `value` 'null', nullable, required
        - `observed_at` union, required
          - string, date-time
          - unknown
        - `revision` union, required
          - string
          - unknown
    - `review_effort` union, required
      - object
        - `status` 'available', required
        - `value` number, required
        - `observed_at` union, required
          - string, date-time
          - unknown
        - `revision` union, required
          - string
          - unknown
      - object
        - `status` 'unknown' | 'stale' | 'unsupported', required
        - `value` 'null', nullable, required
        - `observed_at` union, required
          - string, date-time
          - unknown
        - `revision` union, required
          - string
          - unknown
    - `review_depth` union, required
      - object
        - `status` 'available', required
        - `value` 'light' | 'standard' | 'deep' | 'defer', required
        - `observed_at` union, required
          - string, date-time
          - unknown
        - `revision` union, required
          - string
          - unknown
      - object
        - `status` 'unknown' | 'stale' | 'unsupported', required
        - `value` 'null', nullable, required
        - `observed_at` union, required
          - string, date-time
          - unknown
        - `revision` union, required
          - string
          - unknown
    - `group_key` union, required
      - string
      - unknown
    - `subgroup_key` union, required
      - string
      - unknown
  - `groups` object[], required
    - `key` string, required
    - `label` string, required
    - `count` integer, required
    - `subgroups` object[], required
      - `key` string, required
      - `label` string, required
      - `count` integer, 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
    - `view` 'mine' | 'team', required
    - `team_id` union, required
      - string
      - unknown
    - `group_by` 'none' | 'focus_state' | 'priority' | 'repository' | 'author', required
    - `subgroup_by` 'none' | 'focus_state' | 'priority' | 'repository' | 'author', required
    - `order_by` 'triage' | 'priority' | 'last_activity_at' | 'opened_at' | 'external_id' | 'title', required
    - `order_direction` union, required
      - 'asc' | 'desc'
      - 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/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)