---
title: "Update an existing webhook configuration."
method: POST
path: "/xrpc/place.stream.server.updateWebhook"
tags: ["place.stream.server"]
---

# Update an existing webhook configuration.

`POST /xrpc/place.stream.server.updateWebhook`

## Request body

- object
  - `id` string, required — The ID of the webhook to update.
  - `url` string, uri — The webhook URL where events will be sent.
  - `events` string[] — The types of events this webhook should receive.
  - `active` boolean — Whether this webhook should be active.
  - `prefix` string — Text to prepend to webhook messages.
  - `suffix` string — Text to append to webhook messages.
  - `rewrite` PlaceStreamServerDefsRewriteRule[] — Text replacement rules for webhook messages.
    - `from` string, required — Text to search for and replace.
    - `to` string, required — Text to replace with.
  - `name` string — A user-friendly name for this webhook.
  - `description` string — A description of what this webhook is used for.
  - `muteWords` string[] — Words to filter out from chat messages. Messages containing any of these words will not be forwarded.

## Response `200`

Success

- object
  - `webhook` PlaceStreamServerDefsWebhook, required — A webhook configuration for receiving Streamplace events.
    - `id` string, required — Unique identifier for this webhook.
    - `url` string, uri, required — The webhook URL where events will be sent.
    - `events` string[], required — The types of events this webhook should receive.
    - `active` boolean, required — Whether this webhook is currently active.
    - `prefix` string — Text to prepend to webhook messages.
    - `suffix` string — Text to append to webhook messages.
    - `rewrite` PlaceStreamServerDefsRewriteRule[] — Text replacement rules for webhook messages.
      - `from` string, required — Text to search for and replace.
      - `to` string, required — Text to replace with.
    - `createdAt` string, date-time, required — When this webhook was created.
    - `updatedAt` string, date-time — When this webhook was last updated.
    - `name` string — A user-friendly name for this webhook.
    - `description` string — A description of what this webhook is used for.
    - `lastTriggered` string, date-time — When this webhook was last triggered.
    - `errorCount` integer — Number of consecutive errors for this webhook.
    - `muteWords` string[] — Words to filter out from chat messages. Messages containing any of these words will not be forwarded.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/streamplace/apis/generated-lexicon-api-schema.md) · [All operations](https://skmtc.dev/streamplace/apis/generated-lexicon-api-schema/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/streamplace/generated-lexicon-api-schema/revisions/8e2ce7f5d85b/schema)