---
title: "Update"
method: POST
path: "/api/v1/webhooks/{id}"
tags: ["Webhook"]
---

# Update

`POST /api/v1/webhooks/{id}`

Update an existing webhook subscription's properties, such as its URL or display name.

## Path parameters

- `id` string, required — The unique identifier of the webhook.

## Request body

- C1ApiWebhooksV1WebhooksServiceUpdateRequestInput — The WebhooksServiceUpdateRequest message contains the webhook object to update and a field mask to indicate which fields to update. It uses URL value for input.
  - `updateMask` string, nullable
  - `webhook` C1ApiWebhooksV1Webhook — The Webhook message.
    - `callbackTimeout` string, duration
    - `createdAt` string, date-time
    - `deletedAt` string, date-time
    - `description` string — An optional description of the webhook's purpose.
    - `displayName` string — The human-readable name of the webhook.
    - `id` string — The unique identifier of the webhook.
    - `updatedAt` string, date-time
    - `url` string — The destination URL that receives event notification HTTP callbacks.

## Response `200`

Successful response

- C1ApiWebhooksV1WebhooksServiceUpdateResponse — The WebhooksServiceUpdateResponse message.
  - `webhook` C1ApiWebhooksV1Webhook — The Webhook message.
    - `callbackTimeout` string, duration
    - `createdAt` string, date-time
    - `deletedAt` string, date-time
    - `description` string — An optional description of the webhook's purpose.
    - `displayName` string — The human-readable name of the webhook.
    - `id` string — The unique identifier of the webhook.
    - `updatedAt` string, date-time
    - `url` string — The destination URL that receives event notification HTTP callbacks.

## Changes

- **2026-03-10** `7fa698b04b81` — 2 info
  - added the new optional request property `webhook/callbackTimeout`
  - added the optional property `webhook/callbackTimeout` to the response with the `200` status
- **2025-04-10** `17f9f3bcedd5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/webhooks/:id/post.md)

---

[API](https://skmtc.dev/conductorone/apis/c1-api.md) · [All operations](https://skmtc.dev/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/fa2bb307d6fa/schema)