---
title: "Edit an organization webhook"
method: PUT
path: "/organization/{organizationId}/webhook/{webhookId}"
tags: ["Organization Webhook"]
---

# Edit an organization webhook

`PUT /organization/{organizationId}/webhook/{webhookId}`

## Request

- Base URL: `https://api.qovery.com`
- URL: `https://api.qovery.com/organization/{organizationId}/webhook/{webhookId}`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/qovery/apis/qovery-api/docs/organization/:organizationId/webhook/:webhookId/put.ts> (a function with typed inputs; its response is checked against the schema)

Edit an organization webhook

## Path parameters

- `organizationId` string, uuid, required
- `webhookId` string, uuid, required

## Request body

- OrganizationWebhookCreateRequest
  - `kind` 'STANDARD' | 'SLACK', required: Define the type of the webhook. `SLACK` is a special webhook type to push notifications directly to slack. The `target_url` must be a Slack compatible endpoint.
  - `target_url` string, required: Set the public HTTP or HTTPS endpoint that will receive the specified events. The target URL must starts with `http://` or `https://`
  - `target_secret` string: Make sure you receive a payload to sign the Qovery request with your secret. Qovery will add a HTTP header `Qovery-Signature: <Your Secret>` to every webhook requests sent to your target URL.
  - `description` string
  - `enabled` boolean: Turn on or off your endpoint.
  - `events` OrganizationWebhookEventEnum[], required
  - `project_names_filter` string[]: Specify the project names you want to filter to. This webhook will be triggered only if the event is coming from the specified Project IDs. Notes: 1. Wildcard is accepted E.g. `product*`. 2. Name is case insensitive.
  - `environment_types_filter` EnvironmentModeEnum[]: Specify the environment modes you want to filter to. This webhook will be triggered only if the event is coming from an environment with the specified mode.

## Response `200`

Edit an organization webhook

- OrganizationWebhookCreateResponse
  - `id` string, uuid, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time
  - `kind` 'STANDARD' | 'SLACK': Define the type of the webhook. `SLACK` is a special webhook type to push notifications directly to slack. The `target_url` must be a Slack compatible endpoint.
  - `target_url` string: Set the public HTTP or HTTPS endpoint that will receive the specified events. The target URL must starts with `http://` or `https://`
  - `target_secret_set` boolean
  - `description` string
  - `enabled` boolean: Turn on or off your endpoint.
  - `events` OrganizationWebhookEventEnum[]
  - `project_names_filter` string[]: Specify the project names you want to filter to. This webhook will be triggered only if the event is coming from the specified Project IDs. Notes: 1. Wildcard is accepted E.g. `product*`. 2. Name is case insensitive.
  - `environment_types_filter` EnvironmentModeEnum[]: Specify the environment modes you want to filter to. This webhook will be triggered only if the event is coming from an environment with the specified mode.

## Other responses

- `400`: Bad request
- `401`: Access token is missing or invalid
- `403`: Access forbidden
- `404`: Resource not found

---

[API](https://skmtc.dev/qovery/apis/qovery-api.md) - [All operations](https://skmtc.dev/qovery/apis/qovery-api/llms.txt) - [OpenAPI document](https://skmtc.dev/qovery/apis/qovery-api/revisions/93c4960a44ba?raw)