> ## Documentation Index > Fetch the complete documentation index at: https://docs.coderabbit.ai/llms.txt > Use this file to discover all available pages before exploring further. # List the caller's accessible Triage changes > Returns existing Triage observations and filters under the current viewer's product and repository access. Unknown and stale evidence retain their recorded status. ## OpenAPI ````yaml /openapi.json get /v1/triage/changes openapi: 3.0.3 info: title: CodeRabbit API spec version: 1.0.0 servers: - url: https://api.coderabbit.ai security: - ApiKeyAuth: [] paths: /v1/triage/changes: get: tags: - Triage summary: List the caller's accessible Triage changes description: >- Returns existing Triage observations and filters under the current viewer's product and repository access. Unknown and stale evidence retain their recorded status. operationId: list_triage_changes parameters: - name: org_id in: query schema: type: string minLength: 1 maxLength: 255 pattern: ^[^,\s/\p{Cc}]+$ allowEmptyValue: true allowReserved: true - name: limit in: query schema: type: integer minimum: 1 maximum: 100 default: 50 allowEmptyValue: true allowReserved: true - name: cursor in: query schema: type: string minLength: 1 maxLength: 4096 pattern: ^[A-Za-z0-9_-]+$ allowEmptyValue: true allowReserved: true - name: view in: query schema: enum: - mine - team - organization type: string default: mine description: >- mine selects your personal inbox; team selects a requested-team review view; organization selects all tracked open changes within your repository access. allowEmptyValue: true allowReserved: true - name: team_id in: query schema: type: string minLength: 1 maxLength: 255 pattern: ^[^,\s/\p{Cc}]+$ allowEmptyValue: true allowReserved: true - name: author in: query schema: type: array minItems: 1 items: type: string minLength: 1 maxLength: 255 pattern: ^[^,\s/\p{Cc}]+$ description: >- Provider usernames, or me for the authenticated author. Values are ORed; other filters and the selected view still apply. Display names are not matched. style: form explode: true allowEmptyValue: true allowReserved: true - name: reviewer in: query schema: type: array minItems: 1 items: type: string minLength: 1 maxLength: 255 pattern: ^[^,\s/\p{Cc}]+$ description: >- Provider usernames with an active requested-reviewer, reviewer, approver, or change-requester role; me selects the authenticated person. Values are ORed within this filter. style: form explode: true allowEmptyValue: true allowReserved: true - name: repository_id in: query schema: type: array minItems: 1 items: type: string minLength: 1 maxLength: 255 pattern: ^[^,\s/\p{Cc}]+$ style: form explode: true allowEmptyValue: true allowReserved: true - name: provider in: query schema: type: array minItems: 1 items: enum: - github - gitlab - bitbucket - azure-devops - gerrit type: string style: form explode: true allowEmptyValue: true allowReserved: true - name: priority in: query schema: type: array minItems: 1 items: enum: - p0 - p1 - p2 - p3 - none - unassigned type: string style: form explode: true allowEmptyValue: true allowReserved: true - name: close_candidate in: query schema: enum: - 'true' - 'false' - unknown type: string allowEmptyValue: true allowReserved: true - name: change_type in: query schema: type: array minItems: 1 items: enum: - bugfix - feature - refactor - unclassified type: string style: form explode: true allowEmptyValue: true allowReserved: true - name: blast_radius in: query schema: type: array minItems: 1 items: enum: - low - medium - high - unknown type: string style: form explode: true allowEmptyValue: true allowReserved: true - name: merge_risk in: query schema: type: array minItems: 1 items: enum: - low - medium - high - unknown type: string style: form explode: true allowEmptyValue: true allowReserved: true - name: focus_state in: query schema: type: array minItems: 1 items: enum: - now - next - unassigned type: string style: form explode: true allowEmptyValue: true allowReserved: true - name: attention in: query schema: enum: - all - required - waiting - unknown type: string default: all description: >- Whether the authenticated caller needs to act. Author/reviewer filters do not impersonate another person or change this perspective. allowEmptyValue: true allowReserved: true - name: group_by in: query schema: enum: - none - focus_state - priority - repository - author type: string default: none allowEmptyValue: true allowReserved: true - name: subgroup_by in: query schema: enum: - none - focus_state - priority - repository - author type: string default: none allowEmptyValue: true allowReserved: true - name: order_by in: query schema: enum: - triage - priority - last_activity_at - opened_at - external_id - title type: string default: triage allowEmptyValue: true allowReserved: true - name: order_direction in: query schema: anyOf: - enum: - asc - desc type: string - type: string nullable: true enum: - null allowEmptyValue: true allowReserved: true responses: '200': description: OK content: application/json: schema: type: object properties: data: type: array items: type: object properties: id: type: string minLength: 1 maxLength: 255 pattern: ^[^,\s/\p{Cc}]+$ external_id: type: string minLength: 1 provider: enum: - github - gitlab - bitbucket - azure-devops type: string provider_host: type: string minLength: 1 url: anyOf: - type: string maxLength: 2048 format: uri - type: string nullable: true enum: - null repository: type: object properties: id: anyOf: - type: string minLength: 1 maxLength: 255 pattern: ^[^,\s/\p{Cc}]+$ - type: string nullable: true enum: - null owner: type: string name: type: string required: - id - owner - name additionalProperties: false title: anyOf: - type: string - type: string nullable: true enum: - null state: enum: - open - merged - closed - unknown type: string author: anyOf: - type: object properties: id: anyOf: - type: string minLength: 1 maxLength: 255 pattern: ^[^,\s/\p{Cc}]+$ - type: string nullable: true enum: - null username: anyOf: - type: string - type: string nullable: true enum: - null name: anyOf: - type: string - type: string nullable: true enum: - null required: - id - username - name additionalProperties: false - type: string nullable: true enum: - null head_revision: anyOf: - type: string minLength: 1 - type: string nullable: true enum: - null latest_commit_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null latest_reviewable_observed_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null opened_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null age_seconds: anyOf: - type: integer minimum: 0 maximum: 9007199254740991 - type: string nullable: true enum: - null last_activity_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null last_human_activity_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null change_type: anyOf: - enum: - bugfix - feature - refactor type: string - type: string nullable: true enum: - null focus_state: anyOf: - enum: - now - next type: string - type: string nullable: true enum: - null priority: type: object properties: level: anyOf: - enum: - p0 - p1 - p2 - p3 - none type: string - type: string nullable: true enum: - null source: anyOf: - enum: - calculated - manual type: string - type: string nullable: true enum: - null reason: anyOf: - type: string - type: string nullable: true enum: - null reason_codes: type: array items: type: string score: anyOf: - type: number minimum: 0 maximum: 100 - type: string nullable: true enum: - null confidence: anyOf: - type: number minimum: 0 maximum: 1 - type: string nullable: true enum: - null override: anyOf: - type: object properties: level: enum: - p0 - p1 - p2 - p3 type: string required: - level additionalProperties: false - type: string nullable: true enum: - null required: - level - source - reason - reason_codes - score - confidence - override additionalProperties: false close_candidate: type: object properties: value: anyOf: - type: boolean - type: string nullable: true enum: - null status: enum: - available - unknown - stale - unsupported type: string observed_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null revision: anyOf: - type: string minLength: 1 - type: string nullable: true enum: - null source: anyOf: - enum: - manual - calculated type: string - type: string nullable: true enum: - null reason: anyOf: - type: string - type: string nullable: true enum: - null required: - value - status - observed_at - revision - source - reason additionalProperties: false requires_attention: anyOf: - type: boolean - type: string nullable: true enum: - null attention_reason_codes: type: array items: type: string next_action: type: object properties: kind: anyOf: - enum: - merge - review - find_reviewer - start_review - fix_checks - resolve_conflicts - autofix - refresh_branch - update_change - respond - decide - close - follow - notify - none type: string - type: string nullable: true enum: - null responsible_role: enum: - author - reviewer - maintainer - system - unknown type: string responsible_users: type: array items: type: object properties: id: anyOf: - type: string minLength: 1 maxLength: 255 pattern: ^[^,\s/\p{Cc}]+$ - type: string nullable: true enum: - null username: anyOf: - type: string - type: string nullable: true enum: - null name: anyOf: - type: string - type: string nullable: true enum: - null required: - id - username - name additionalProperties: false reason_codes: type: array items: type: string status: enum: - available - unknown type: string required: - kind - responsible_role - responsible_users - reason_codes - status additionalProperties: false review_status: anyOf: - type: object properties: status: enum: - available value: enum: - reviewed - new_changes_since_review - review_needed - review_starting - reviewing - review_failed - no_reviewable_changes type: string observed_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null revision: anyOf: - type: string minLength: 1 - type: string nullable: true enum: - null required: - status - value - observed_at - revision additionalProperties: false - type: object properties: status: enum: - unknown - stale - unsupported type: string value: type: string nullable: true enum: - null observed_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null revision: anyOf: - type: string minLength: 1 - type: string nullable: true enum: - null required: - status - value - observed_at - revision additionalProperties: false description: >- Review evidence. Unconfirmed in-progress observations use stale status with a null value; observed_at and revision retain the last observation. approval_status: anyOf: - type: object properties: status: enum: - available value: enum: - approved - changes_requested - review_required - stale_approval type: string observed_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null revision: anyOf: - type: string minLength: 1 - type: string nullable: true enum: - null required: - status - value - observed_at - revision additionalProperties: false - type: object properties: status: enum: - unknown - stale - unsupported type: string value: type: string nullable: true enum: - null observed_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null revision: anyOf: - type: string minLength: 1 - type: string nullable: true enum: - null required: - status - value - observed_at - revision additionalProperties: false blast_radius: anyOf: - type: object properties: status: enum: - available value: enum: - low - medium - high type: string observed_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null revision: anyOf: - type: string minLength: 1 - type: string nullable: true enum: - null required: - status - value - observed_at - revision additionalProperties: false - type: object properties: status: enum: - unknown - stale - unsupported type: string value: type: string nullable: true enum: - null observed_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null revision: anyOf: - type: string minLength: 1 - type: string nullable: true enum: - null required: - status - value - observed_at - revision additionalProperties: false merge_risk: anyOf: - type: object properties: status: enum: - available value: type: object properties: level: enum: - low - medium - high type: string score: type: number minimum: 0 maximum: 1 basis: enum: - direct - proxy - mixed - unknown type: string reason: anyOf: - type: string - type: string nullable: true enum: - null required: - level - score - basis - reason additionalProperties: false observed_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null revision: anyOf: - type: string minLength: 1 - type: string nullable: true enum: - null required: - status - value - observed_at - revision additionalProperties: false - type: object properties: status: enum: - unknown - stale - unsupported type: string value: type: string nullable: true enum: - null observed_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null revision: anyOf: - type: string minLength: 1 - type: string nullable: true enum: - null required: - status - value - observed_at - revision additionalProperties: false security_risk: anyOf: - type: object properties: status: enum: - available value: type: object properties: level: enum: - minimal - low - moderate - high - critical type: string reason: anyOf: - type: string - type: string nullable: true enum: - null required: - level - reason additionalProperties: false observed_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null revision: anyOf: - type: string minLength: 1 - type: string nullable: true enum: - null required: - status - value - observed_at - revision additionalProperties: false - type: object properties: status: enum: - unknown - stale - unsupported type: string value: type: string nullable: true enum: - null observed_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null revision: anyOf: - type: string minLength: 1 - type: string nullable: true enum: - null required: - status - value - observed_at - revision additionalProperties: false review_effort: anyOf: - type: object properties: status: enum: - available value: type: number minimum: 0 maximum: 1 observed_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null revision: anyOf: - type: string minLength: 1 - type: string nullable: true enum: - null required: - status - value - observed_at - revision additionalProperties: false - type: object properties: status: enum: - unknown - stale - unsupported type: string value: type: string nullable: true enum: - null observed_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null revision: anyOf: - type: string minLength: 1 - type: string nullable: true enum: - null required: - status - value - observed_at - revision additionalProperties: false review_depth: anyOf: - type: object properties: status: enum: - available value: enum: - light - standard - deep - defer type: string observed_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null revision: anyOf: - type: string minLength: 1 - type: string nullable: true enum: - null required: - status - value - observed_at - revision additionalProperties: false - type: object properties: status: enum: - unknown - stale - unsupported type: string value: type: string nullable: true enum: - null observed_at: anyOf: - type: string format: date-time - type: string nullable: true enum: - null revision: anyOf: - type: string minLength: 1 - type: string nullable: true enum: - null required: - status - value - observed_at - revision additionalProperties: false group_key: anyOf: - type: string minLength: 1 - type: string nullable: true enum: - null subgroup_key: anyOf: - type: string minLength: 1 - type: string nullable: true enum: - null required: - id - external_id - provider - provider_host - url - repository - title - state - author - head_revision - latest_commit_at - latest_reviewable_observed_at - opened_at - age_seconds - last_activity_at - last_human_activity_at - change_type - focus_state - priority - close_candidate - requires_attention - attention_reason_codes - next_action - review_status - approval_status - blast_radius - merge_risk - security_risk - review_effort - review_depth - group_key - subgroup_key additionalProperties: false groups: type: array items: type: object properties: key: type: string minLength: 1 label: type: string count: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true subgroups: type: array items: type: object properties: key: type: string minLength: 1 label: type: string count: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - key - label - count additionalProperties: false required: - key - label - count - subgroups additionalProperties: false next_cursor: anyOf: - type: string minLength: 1 maxLength: 4096 pattern: ^[A-Za-z0-9_-]+$ - type: string nullable: true enum: - null meta: type: object properties: request_id: type: string minLength: 1 org_id: type: string minLength: 1 maxLength: 255 pattern: ^[^,\s/\p{Cc}]+$ generated_at: type: string format: date-time total_count: type: integer minimum: 0 maximum: 9007199254740991 limit: type: integer minimum: 1 maximum: 100 view: enum: - mine - team - organization type: string team_id: anyOf: - type: string minLength: 1 maxLength: 255 pattern: ^[^,\s/\p{Cc}]+$ - type: string nullable: true enum: - null group_by: enum: - none - focus_state - priority - repository - author type: string subgroup_by: enum: - none - focus_state - priority - repository - author type: string order_by: enum: - triage - priority - last_activity_at - opened_at - external_id - title type: string order_direction: anyOf: - enum: - asc - desc type: string - type: string nullable: true enum: - null required: - request_id - org_id - generated_at - total_count - limit - view - team_id - group_by - subgroup_by - order_by - order_direction additionalProperties: false required: - data - groups - next_cursor - meta additionalProperties: false '400': description: '400' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - invalid_request type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '401': description: '401' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - unauthenticated type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '403': description: '403' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - forbidden type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '404': description: '404' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - not_found type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '409': description: '409' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - head_changed - conflict type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '412': description: '412' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - precondition_failed type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '413': description: '413' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - payload_too_large type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '429': description: '429' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - rate_limit_exceeded type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '500': description: '500' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - internal_error type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '503': description: '503' content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unavailable message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-coderabbitai-api-key description: >- API key for authentication. You can create an API key from the CodeRabbit dashboard. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.