Update community (Admin)

PUT/manage/communities/:id

Update a community. Admins only.

Auth	Login required

Path parameters

idstringrequired

Community ID or slug.

Request body

namestringoptional

Community name (required); up to 50 characters.

joinTypestringoptional

One of APPROVAL_REQUIRED / FREE_JOIN / INVITATION_ONLY.

visibilitystringoptional

One of PUBLIC / PRIVATE / LIMITED.

descriptionstringoptional

Description; up to 500 characters.

languagesLanguagesoptional

Localized name / description.

logoUrlstringoptional

Logo image URL; must be a valid URL.

contactContact[]optional

Contact information.

tagsstring[]optional

Array of tag names.

slugstringoptional

3–200 characters; lowercase alphanumerics, hyphens and underscores only (^[a-z0-9-_]+$). Must be unique.

logoDarkUrlstringoptional

Dark-theme logo URL; must be a valid URL.

enabledChatbooleanoptional

Whether chat is enabled.

customNavigationCustomNavigationoptional

Custom navigation settings.

cardDesignstring | nulloptional

The community's business card design: a background image ID (e.g. solid-07-h216) or "custom" to use a photo. "custom" requires a photo (cardPhoto). Send null to reset.

cardPhotoCardPhoto | nulloptional

The photo for the community's business card and how it is shown (url, brightness and textColor are all required). url must be one returned by POST /manage/communities/:id/card-photo for the same community. Send null to remove the photo (not allowed while cardDesign is "custom").

Notes

cardDesign and cardPhoto are validated the same way as PUT /users/me. An unsupported design ID, a photo belonging to another community or a user, an external URL, or "custom" without a photo returns 400. When only one of them is sent, it is merged onto the saved setting before validation.

Response

Returns Community.

Request

curl https://api.4s.link/manage/communities/ID \
  -X PUT \
  -H "Authorization: Bearer 4s_at_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Tech Community",
  "enabledChat": true
}'

Example response

{
  "id": "c1a2b3c4-...",
  "slug": "tech-community",
  "name": "Tech Community",
  "description": "...",
  "joinType": "FREE_JOIN",
  "visibility": "PUBLIC",
  "logoUrl": "https://.../logo.png",
  "logoDarkUrl": null,
  "enabledChat": true,
  "cardDesign": "solid-07-h216",
  "cardPhoto": null,
  "tags": []
}