Sign in

v56

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-011,4581,08113.3 MB
issues

Approve an issue suggestion

Approves a pending suggestion on an issue. Applies the proposed change (creating the corresponding timeline event), transitions the suggestion to approved, and dismisses any competing pending suggestions for the same change.

Requires triage access to the repository. Approving a suggestion also requires permission to perform the change it applies (for example, setting the issue type, adding a label or assignee, or closing the issue); this only affects fine-grained access tokens and GitHub Apps whose permissions are narrower than the triage role. This endpoint only supports issues, not pull requests.

post/repos/{owner}/{repo}/issues/{issue_number}/suggestions/{suggestion_id}/approve

Path parameters

ownerstring required

The account owner of the repository. The name is not case sensitive.

repostring required

The name of the repository without the .git extension. The name is not case sensitive.

issue_numberinteger required

The number that identifies the issue.

suggestion_idinteger required

The unique identifier of the suggestion.

Response

Response

idinteger required

The unique identifier of the suggestion.

issue_idinteger 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_idinteger nullable required

The identifier of the target the change applies to (issue type, label, field, assignee, or duplicate issue), when applicable.

rationalestring 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_idinteger nullable required

The unique identifier of the actor that proposed the suggestion.

issue_event_idinteger nullable required

The identifier of the timeline event created when the suggestion was approved, when applicable.

resolved_byinteger nullable required

The unique identifier of the user who approved or dismissed the suggestion.

created_atstring date-time required

The time the suggestion was created.

updated_atstring date-time required

The time the suggestion was last updated.