---
title: "PUT /webhooks/{id}/"
method: PUT
path: "/webhooks/{id}/"
tags: ["webhooks"]
---

# PUT /webhooks/{id}/

`PUT /webhooks/{id}/`

## Path parameters

- `id` string, uuid, required

## Query parameters

- `format` 'json' | 'xlsx'

## Request body

- Webhook
  - `id` string, uuid, required
  - `url` string, uri, required
  - `account` string, uri, required
  - `name` string, required
  - `version` '2.4.5' | '2.4.4' | '2.4.3' | '2.4.2' | '2.4.1' | '2.3.5' | '2.3.4' | '2.3.3' | '2.3.2' | '2.3.1' | '2.3.0' | '2.2.6' | '2.2.5' | '2.2.4' | '2.2.3' | '2.2.2' | '2.2.1' | '2.2.0' | '2.1.1' | '2.1.0' | '2.0.0' | '1.1.0' | '1.0.0'
  - `state` 'inactive' | 'active' | 'disabled', required
  - `headers` object
  - `target` string, uri, required
  - `task_events` boolean
  - `document_events` boolean
  - `signature_events` boolean
  - `review_events` boolean
  - `notification_emails` string[]
  - `failure_count` integer, required
  - `disable_message` string, required
  - `shared_secret` string
  - `activated_at` string, date-time, required
  - `disabled_at` string, date-time, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Response `200`

## Changes

- **2022-09-08** `486e2fd12f8f` — 10 warning, 17 info
  - added the new `2.4.1` enum value to the `version` response property for the response status `200` (media type: application/json; version=2.4.5)
  - added the new `2.4.1` enum value to the `version` response property for the response status `200` (media type: application/xlsx; version=2.4.5)
  - added the new `2.4.2` enum value to the `version` response property for the response status `200` (media type: application/json; version=2.4.5)
  - added the new `2.4.2` enum value to the `version` response property for the response status `200` (media type: application/xlsx; version=2.4.5)
  - …23 more
- **2022-08-19** `8446ece0e148` — 39 breaking, 28 info
  - removed the enum value `2.4.1` of the request property `version` (media type: application/json)
  - removed the enum value `2.4.1` of the request property `version` (media type: application/x-www-form-urlencoded)
  - removed the enum value `2.4.1` of the request property `version` (media type: multipart/form-data)
  - removed the enum value `2.4.10` of the request property `version` (media type: application/json)
  - …63 more

[Change history](https://skmtc.dev/oeklo/apis/gsmtasks-project-api/changes/webhooks/:id/put.md)

---

[API](https://skmtc.dev/oeklo/apis/gsmtasks-project-api.md) · [All operations](https://skmtc.dev/oeklo/apis/gsmtasks-project-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/oeklo/gsmtasks-project-api/revisions/486e2fd12f8f/schema)