---
title: "Update forum"
method: PATCH
path: "/forums/{id}"
tags: ["Forums"]
---

# Update forum

`PATCH /forums/{id}`

Update moderation and notification settings for a forum, such as who can post, who can comment, and email notification preferences.

Required permissions:
 - `forum:moderate`

## Path parameters

- `id` string, required

## Request body

- object — Parameters for UpdateForum
  - `banned_words` string[], nullable — A list of words that are automatically blocked from posts in this forum. For example, ['spam', 'scam'].
  - `banner_image` object, nullable — The banner image displayed at the top of the forum page. Pass null to remove the existing banner.
    - `id` string, required — The ID of an existing file object.
  - `email_notification_preference` 'all_admin_posts' | 'only_weekly_summary' | 'none' — Email notification preference option for a forum feed
  - `who_can_comment` 'everyone' | 'admins' — Who can comment on a forum feed
  - `who_can_post` 'everyone' | 'admins' — Who can post on a forum feed

## Response `200`

A successful response

- Forum — A discussion forum where members can create posts, comment, and react, belonging to an experience.
  - `email_notification_preference` 'all_admin_posts' | 'only_weekly_summary' | 'none', required — Email notification preference option for a forum feed
  - `experience` object, required — The parent experience that this forum belongs to.
    - `id` string, required — The unique identifier for the experience.
    - `name` string, required — The display name of this experience shown to users in the product navigation. Maximum 255 characters.
  - `id` string, required — The unique identifier for the entity
  - `who_can_comment` 'everyone' | 'admins', required — Who can comment on a forum feed
  - `who_can_post` 'everyone' | 'admins', required — Who can post on a forum feed

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `422` — Verification required
- `429` — Too many requests
- `500` — Internal server error

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/866821546d67/schema)