---
title: "Get a webhook for a workspace"
method: GET
path: "/workspaces/{workspace}/hooks/{uid}"
tags: ["Workspaces", "Webhooks"]
---

# Get a webhook for a workspace

`GET /workspaces/{workspace}/hooks/{uid}`

Returns the webhook with the specified id installed on the given
workspace.

## Response `200`

The webhook subscription object.

- WebhookSubscription — A Webhook subscription.
  - `type` string, required
  - `uuid` string — The webhook's id
  - `url` string, uri — The URL events get delivered to.
  - `description` string — A user-defined description of the webhook.
  - `subject_type` 'repository' | 'workspace' — The type of entity. Set to either `repository` or `workspace` based on where the subscription is defined.
  - `subject` Object — Base type for most resource objects. It defines the common `type` element that identifies an object's type. It also identifies the element as Swagger's `discriminator`.
    - `type` string, required
  - `active` boolean
  - `created_at` string, date-time
  - `events` string[] — The events this webhook is subscribed to.
  - `secret_set` boolean — Indicates whether or not the hook has an associated secret. It is not possible to see the hook's secret. This field is ignored during updates.
  - `secret` string — The secret to associate with the hook. The secret is never returned via the API. As such, this field is only used during updates. The secret can be set to `null` or "" to remove the secret (or create a hook with no secret). Leaving out the secret field during updates will leave the secret unchanged. Leaving out the secret during creation will create a hook with no secret.

## Other responses

- `404` — If the webhook or workspace does not exist.

---

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