# Update a webhook endpoint `PUT /webhooks/{id}` **Required scope:** `webhooks:manage` Not usable by an agent key, which never carries webhooks:manage. ## Parameters | Name | In | Required | Description | |---|---|---|---| | `id` | path | yes | id of the target record | ## Request body Content type: `application/json` | Field | Type | Required | Description | |---|---|---|---| | `url` | string | no | HTTPS endpoint to deliver to (optional) | | `events` | string | no | array of event names to subscribe to (optional) | | `isActive` | string | no | true or false (optional) | ## Responses | Status | Meaning | |---|---| | `200` | Success | | `400` | BadRequest | | `401` | Unauthorized | | `403` | Forbidden | | `429` | RateLimited | ## Example ```bash curl -X PUT "https://backend.immut.io/api/v1/webhooks/" \ -H "Authorization: Bearer $IMMUT_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"","events":"","isActive":""}' ``` ## OpenAPI fragment ```json { "/webhooks/{id}": { "put": { "operationId": "putwebhooksid", "summary": "Update a webhook endpoint. Not usable by an agent key, which never carries webhooks:manage.", "description": "Update a webhook endpoint. Not usable by an agent key, which never carries webhooks:manage.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "id of the target record" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "description": "HTTPS endpoint to deliver to (optional)" }, "events": { "type": "string", "description": "array of event names to subscribe to (optional)" }, "isActive": { "type": "string", "description": "true or false (optional)" } } } } } }, "responses": { "200": { "description": "Success" }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "tags": [ "Webhooks" ], "x-required-scope": "webhooks:manage" } } } ```