---
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.

---

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