webhooks_modify
webhooks_modify
Section titled “webhooks_modify”Category: webhooks
Update a webhook (rename, re-avatar, move to a different channel).
When to use
Section titled “When to use”- Change the channel a webhook posts to (
channel_id) — only available on the bot-auth path.
When NOT to use
Section titled “When NOT to use”| Field | Type | Required | Description |
|---|---|---|---|
webhook_id | string | yes | Webhook to modify |
name | string | no | New display name |
avatar | unknown | no | base64-encoded image data URI for the avatar, or null to clear |
channel_id | string | no | Move the webhook to this channel |
audit_reason | string | no | Reason recorded in audit log (X-Audit-Log-Reason header) |
Returns
Section titled “Returns”Updated webhook record (no token). name wrapped untrusted.
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
id | string | yes | Discord webhook ID |
type | integer | yes | |
channel_id | unknown | yes | |
application_id | unknown | yes | |
name | unknown | yes | |
avatar | unknown | yes | |
untrusted_name | string | yes |
Annotations
Section titled “Annotations”| Property | Value |
|---|---|
| Read-only | no |
| Destructive | no |
| Idempotent | yes |
| Open-world | yes |
| Confirmation required | no |