Update a webhook endpoint

Update a webhook endpoint’s address, event subscriptions, or status (active re-enables, disabled pauses; re-enabling does not re-send the gap, replay covers it). destination_kind cannot change: batches already planned against the old transport are in flight, so a move means a new endpoint alongside this one until it has drained.

PATCH /api/webhooks/v1/endpoints/{id}

Update a webhook endpoint

Python

import requests

url = "https://app.langwatch.ai/api/webhooks/v1/endpoints/{id}"

payload = {
    "url": "<string>",
    "sqs": {
        "queue_url": "<string>",
        "role_arn": "<string>",
        "external_id": "<string>",
        "access_key_id": "<string>",
        "secret_access_key": "<string>"
    },
    "enabled_events": ["<string>"],
    "max_batch_size": 0,
    "max_batch_delay_ms": 0,
    "max_in_flight": 0
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

200

{
  "data": {
    "destination_kind": "http",
    "url": "<string>",
    "sqs": null,
    "id": "<string>",
    "enabled_events": [
      "<string>"
    ],
    "status": "active",
    "disabled_reason": "<string>",
    "disabled_at": "<string>",
    "failing_since": "<string>",
    "last_success_at": "<string>",
    "last_failure_at": "<string>",
    "max_batch_size": 0,
    "max_batch_delay_ms": 0,
    "max_in_flight": 0,
    "created_at": "<string>",
    "updated_at": "<string>"
  }
}

Authorizations

Authorization · string · header · required

Admin API key for organization-level operations (managing projects, API keys). Create one in Settings > API Keys or via POST /api/api-keys. Format: sk-lw-{id}_{secret}.

Path Parameters

id · string · required

Minimum string length: 1

Body

application/json

destination_kind · enum<string>

Available options: http, sqs

url · string

Required string length: 1 - 2000

sqs · object

Show child attributes

enabled_events · string[]

Required array length: 1 - 100 elements

Required string length: 1 - 200

status · enum<string>

Available options: active, disabled

max_batch_size · integer

Required range: -9007199254740991 <= x <= 9007199254740991

max_batch_delay_ms · integer

Required range: -9007199254740991 <= x <= 9007199254740991

max_in_flight · integer

Required range: -9007199254740991 <= x <= 9007199254740991

Response

200 - application/json

Success

data · object · required

Option 1

Option 2

Show child attributes