---
title: "Delete a webhook for a repository"
method: DELETE
path: "/repositories/{workspace}/{repo_slug}/hooks/{uid}"
tags: ["Repositories", "Webhooks"]
---

# Delete a webhook for a repository

`DELETE /repositories/{workspace}/{repo_slug}/hooks/{uid}`

## Request

- Base URL: `https://api.bitbucket.org/2.0`
- URL: `https://api.bitbucket.org/2.0/repositories/{workspace}/{repo_slug}/hooks/{uid}`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://bitbucket.org/site/oauth2/authorize`
    - Token URL: `https://bitbucket.org/site/oauth2/access_token` scopes: `webhook`
  - HTTP basic
  - API key in header `Authorization`

Deletes the specified webhook subscription from the given
repository.

## Path parameters

- `workspace` string, required
- `repo_slug` string, required
- `uid` string, required

## Response `204`

When the webhook was deleted successfully

## Other responses

- `403`: If the authenticated user does not have permission to update the webhook.
- `404`: If the webhook or repository does not exist.

## Changes

- **2026-10-03** `869214428f35`: 3 breaking, 1 info
  - added the new path request parameter `repo_slug`
  - added the new path request parameter `uid`
  - added the new path request parameter `workspace`
  - api operation id `delete_repository_hook` was added

[Operation history](https://skmtc.dev/atlassian/apis/bitbucket-api/changes/repositories/:workspace/:repo_slug/hooks/:uid/delete.md)

---

[API](https://skmtc.dev/atlassian/apis/bitbucket-api.md) - [All operations](https://skmtc.dev/atlassian/apis/bitbucket-api/llms.txt) - [OpenAPI document](https://skmtc.dev/atlassian/apis/bitbucket-api/revisions/6ae783fa75da?raw)