---
title: "PATCH /webhooks/{webhook_id}/"
method: PATCH
path: "/webhooks/{webhook_id}/"
tags: ["webhooks"]
---

# PATCH /webhooks/{webhook_id}/

`PATCH /webhooks/{webhook_id}/`

## Path parameters

- `webhook_id` string, required

## Request body

- WebhookUpdateSchema
  - `name` string
  - `avatar` string
  - `channel_id` string

## Response `200`

- WebhookCreateResponse
  - `user` PublicUser, required
    - `id` string, required — A Twitter-like snowflake, except the epoch is 2015-01-01T00:00:00.000Z ``` If we have a snowflake '266241948824764416' we can represent it as binary: 64 22 17 12 0 000000111011000111100001101001000101000000 00001 00000 000000000000 number of ms since Discord epoch worker pid increment ```
    - `premium_since` string, date-time, required
    - `avatar` string
    - `banner` string
    - `bio` string, required
    - `theme_colors` integer[]
    - `pronouns` string
    - `username` string, required
    - `discriminator` string, required
    - `public_flags` integer, required
    - `accent_color` integer
    - `bot` boolean, required
    - `premium_type` integer, required
    - `badge_ids` string[]
    - `avatar_decoration_data` AvatarDecorationData
      - `asset` string, required
      - `sku_id` string, required — A Twitter-like snowflake, except the epoch is 2015-01-01T00:00:00.000Z ``` If we have a snowflake '266241948824764416' we can represent it as binary: 64 22 17 12 0 000000111011000111100001101001000101000000 00001 00000 000000000000 number of ms since Discord epoch worker pid increment ```
      - `expires_at` string, nullable, required
    - `display_name_styles` DisplayNameStyle
      - `font_id` integer, required
      - `effect_id` integer, required
      - `colors` integer[], required
    - `collectibles` Collectibles
      - `nameplate` NameplateData, required
        - `asset` string, required
        - `sku_id` string, required — A Twitter-like snowflake, except the epoch is 2015-01-01T00:00:00.000Z ``` If we have a snowflake '266241948824764416' we can represent it as binary: 64 22 17 12 0 000000111011000111100001101001000101000000 00001 00000 000000000000 number of ms since Discord epoch worker pid increment ```
        - `label` string, required
        - `palette` string, required
        - `expires_at` integer, nullable, required
    - `primary_guild` PrimaryGuild
      - `identity_enabled` boolean, nullable, required
      - `identity_guild_id` string, nullable, required
      - `tag` string, nullable, required
      - `badge` string, nullable, required
  - `hook` WebhookResponse, required — unresolved $ref

## Other responses

- `400`
- `403` — No description available
- `404` — No description available

## Changes

- **2026-07-15** `4eaddbefcd80` — 36 breaking, 10 warning, 3 info
  - the `hook` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the required property `hook/application` from the response with the `200` status
  - removed the required property `hook/application_id` from the response with the `200` status
  - removed the required property `hook/avatar` from the response with the `200` status
  - …45 more
- **2026-07-01** `df450366996c` — 13 info
  - added the required property `hook/application/owner_id` to the response with the `200` status
  - added the required property `hook/channel/messages/items/application/owner_id` to the response with the `200` status
  - added the required property `hook/guild/afk_channel/messages/items/application/owner_id` to the response with the `200` status
  - added the required property `hook/guild/channels/items/messages/items/application/owner_id` to the response with the `200` status
  - …9 more
- **2026-06-30** `db6940245023` — 2 breaking, 17 info
  - the response property `hook/guild/emojis/items/guild_id` became nullable for the status `200`
  - the response property `hook/source_guild/emojis/items/guild_id` became nullable for the status `200`
  - added the required property `hook/application/emojis` to the response with the `200` status
  - added the required property `hook/channel/messages/items/application/emojis` to the response with the `200` status
  - …15 more
- …earlier changes not shown

[Full history](https://skmtc.dev/spacebarchat/apis/spacebar-server/changes/webhooks/:webhook_id/patch.md)

---

[API](https://skmtc.dev/spacebarchat/apis/spacebar-server.md) · [All operations](https://skmtc.dev/spacebarchat/apis/spacebar-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spacebarchat/spacebar-server/revisions/a15db2c050e7/schema)