---
title: "List issue suggestions"
method: GET
path: "/repos/{owner}/{repo}/issues/{issue_number}/suggestions"
tags: ["issues"]
---

# List issue suggestions

`GET /repos/{owner}/{repo}/issues/{issue_number}/suggestions`

Lists the suggestions on an issue. A suggestion is an agent-proposed change to an issue's type, labels, fields, assignees, or closed state that a maintainer can approve or dismiss.

By default only pending suggestions are returned. Use `state=all` to return suggestions in every state, or `state=<state>` to filter to a single state. Use `action=<action>` to return only suggestions for a specific change.

This endpoint is only available while the issue suggestions feature is enabled for the repository, and only supports issues, not pull requests.

Requires triage access to the repository.

## Path parameters

- `owner` string, required
- `repo` string, required
- `issue_number` integer, required

## Query parameters

- `state` 'pending' | 'applied' | 'approved' | 'dismissed' | 'replaced' | 'invalidated' | 'all'
- `action` 'set_type' | 'add_label' | 'add_field' | 'add_assignee' | 'close_issue'
- `per_page` integer
- `page` integer

## Response `200`

Response

- IssueSuggestion[]
  - `id` integer, required — The unique identifier of the suggestion.
  - `issue_id` integer, required — The unique identifier of the issue the suggestion applies to.
  - `action` 'set_type' | 'add_label' | 'add_field' | 'add_assignee' | 'close_issue', required — The kind of change proposed.
  - `state` 'pending' | 'applied' | 'approved' | 'dismissed' | 'replaced' | 'invalidated', required — The suggestion's lifecycle state.
  - `target_id` integer, nullable, required — The identifier of the target the change applies to (issue type, label, field, assignee, or duplicate issue), when applicable.
  - `target_value` union, required — The proposed value, when applicable. An array for multi-select field suggestions.
    - string
    - number
    - boolean
    - string[]
  - `rationale` string, nullable, required — The rationale the actor provided for the suggestion.
  - `confidence` 'LOW' | 'MEDIUM' | 'HIGH', nullable, required — The actor's confidence level in the suggestion.
  - `actor_id` integer, nullable, required — The unique identifier of the actor that proposed the suggestion.
  - `issue_event_id` integer, nullable, required — The identifier of the timeline event created when the suggestion was approved, when applicable.
  - `resolved_by` integer, nullable, required — The unique identifier of the user who approved or dismissed the suggestion.
  - `created_at` string, date-time, required — The time the suggestion was created.
  - `updated_at` string, date-time, required — The time the suggestion was last updated.

## Other responses

- `404` — Resource not found
- `422` — Validation failed, or the endpoint has been spammed.

---

[API](https://skmtc.net/github/apis/rest-api.md) · [All operations](https://skmtc.net/github/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/rest-api/versions/80850db290cd/schema)