---
title: "Update a webhook endpoint"
method: PUT
path: "/webhook-endpoints/{id}"
tags: ["Webhooks"]
---

# Update a webhook endpoint

`PUT /webhook-endpoints/{id}`

## Request

- Base URL: `https://workflow.loopfour.ai/api/v1`
- URL: `https://workflow.loopfour.ai/api/v1/webhook-endpoints/{id}`
- Auth: API key in header `x-api-key`

Updates webhook endpoint configuration. Fields set to null clear the value.

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string
  - `url` string, uri
  - `events` string[], nullable: Event types (null clears to all events).
  - `workflowIds` string[], nullable: Workflow IDs (null clears to all workflows).
  - `headers` object, nullable: Custom headers (null clears).
  - `status` 'active' | 'paused'
  - `description` string, nullable: Description (null clears).

## Response `200`

Success

- object
  - `success` unknown
  - `data` WebhookEndpoint
    - `id` string
    - `name` string
    - `url` string, uri
    - `events` string[], nullable
    - `workflowIds` string[], nullable
    - `headers` object, nullable
    - `status` 'active' | 'paused' | 'disabled'
    - `lastDeliveredAt` string, date-time, nullable
    - `consecutiveFailures` number
    - `description` string, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `400`: Bad request — invalid parameters or request body.
- `401`: Missing or invalid API key.
- `403`: Forbidden — insufficient permissions for this resource.
- `404`: Resource not found.

---

[API](https://skmtc.dev/loopfour/apis/loopfour-workflows-api.md) - [All operations](https://skmtc.dev/loopfour/apis/loopfour-workflows-api/llms.txt) - [OpenAPI document](https://skmtc.dev/loopfour/apis/loopfour-workflows-api/revisions/872822a3af00?raw)