---
title: "Create a dismissal request for a Dependabot alert for a repository"
method: POST
path: "/repos/{owner}/{repo}/dismissal-requests/dependabot/{alert_number}"
tags: ["dependabot"]
---

# Create a dismissal request for a Dependabot alert for a repository

`POST /repos/{owner}/{repo}/dismissal-requests/dependabot/{alert_number}`

Creates a new dismissal request to dismiss a Dependabot alert in a repository.

Delegated alert dismissal must be enabled on the repository and the user must have permission to view Dependabot alerts to access this endpoint.
OAuth app tokens and personal access tokens (classic) need the `security_events` scope to use this endpoint.

## Path parameters

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

## Request body

- object
  - `dismissed_reason` 'fix_started' | 'no_bandwidth' | 'tolerable_risk' | 'inaccurate' | 'not_used', required — The reason for dismissing the alert.
  - `dismissed_comment` string — An optional comment explaining the dismissal.

## Response `201`

The created dismissal request.

- DependabotAlertDismissalRequest — Alert dismissal request made by a user asking to dismiss a Dependabot alert.
  - `id` integer — The unique identifier of the dismissal request.
  - `number` integer — The number uniquely identifying the dismissal request within its repository.
  - `repository` object — The repository the dismissal request is for.
    - `id` integer — The ID of the repository the dismissal request is for.
    - `name` string — The name of the repository the dismissal request is for.
    - `full_name` string — The full name of the repository the dismissal request is for.
  - `organization` object — The organization associated with the repository the dismissal request is for.
    - `id` integer — The ID of the organization.
    - `name` string — The name of the organization.
  - `requester` object — The user who requested the dismissal request.
    - `actor_id` integer — The ID of the GitHub user who requested the dismissal request.
    - `actor_name` string — The name of the GitHub user who requested the dismissal request.
  - `request_type` string — The type of request.
  - `data` object[], nullable — Data describing the dismissal request metadata.
    - `reason` string — The reason for the dismissal request.
    - `alert_number` string — The alert number.
    - `alert_title` string — The title of the alert.
  - `resource_identifier` string — The unique identifier for the request type of the dismissal request.
  - `status` 'pending' | 'denied' | 'approved' | 'expired' — The status of the dismissal request.
  - `requester_comment` string, nullable — The comment the requester provided when creating the dismissal request.
  - `expires_at` string, date-time — The date and time the dismissal request will expire.
  - `created_at` string, date-time — The date and time the dismissal request was created.
  - `responses` DismissalRequestResponse[], nullable — The responses to the dismissal request.
    - `id` integer — The ID of the response to the dismissal request.
    - `reviewer` object — The user who reviewed the dismissal request.
      - `actor_id` integer — The ID of the GitHub user who reviewed the dismissal request.
      - `actor_name` string — The name of the GitHub user who reviewed the dismissal request.
    - `message` string, nullable — The response comment of the reviewer.
    - `status` 'approved' | 'denied' | 'dismissed' — The response status to the dismissal request until dismissed.
    - `created_at` string, date-time — The date and time the response to the dismissal request was created.
  - `url` string, uri
  - `html_url` string, uri — The URL to view the dismissal request in a browser.

## Other responses

- `403` — Forbidden
- `404` — Resource not found
- `422` — Validation failed, or the endpoint has been spammed.
- `500` — Internal Error

---

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