---
title: "Update a webhook"
method: PUT
path: "/v1/webhooks/{id}"
tags: ["webhooks"]
---

# Update a webhook

`PUT /v1/webhooks/{id}`

Updates webhook endpoint settings. Event schemas are managed through the nested event_schemas resource, not through webhook updates.

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Request body

- object
  - `url` string — Webhook endpoint URL
  - `secret` string — Secret for webhook signature verification
  - `disabled_at` string — Timestamp when webhook was disabled
  - `enabled_events` string[] — Array of event types to subscribe to
  - `oidc_auth_method` 'private_key_jwt' | 'client_secret' — OIDC authentication method for obtaining access tokens. Required when configuring OIDC. 'private_key_jwt' — requires oidc_client_id, oidc_token_endpoint, oidc_access_token_ttl_seconds. 'client_secret' — requires oidc_client_id, oidc_client_secret, oidc_token_endpoint, oidc_access_token_ttl_seconds. Both methods optionally accept oidc_scope and oidc_resource_uri.
  - `oidc_client_id` string — OIDC client ID. Required for both auth methods.
  - `oidc_client_secret` string — OIDC client secret. Required when oidc_auth_method is 'client_secret'. Write-only; never returned in responses.
  - `oidc_token_endpoint` string — OIDC token endpoint URL. Required for both auth methods.
  - `oidc_resource_uri` string — Optional. OIDC resource URI (Microsoft-specific; use oidc_scope for standard OAuth 2.0).
  - `oidc_scope` string — Optional. OAuth 2.0 scope for the token request (e.g. "api://<app-id>/.default").
  - `oidc_access_token_ttl_seconds` integer — OIDC access token TTL in seconds. Required for both auth methods.

## Response `200`

webhook updated

- unknown

## Other responses

- `404` — webhook not found

---

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