English
コミュニティ（管理者用）

コミュニティを更新（管理者用）

PUT/manage/communities/:id

コミュニティ情報を更新します。ADMIN のみ実行できます。

認証要ログイン

パスパラメータ

idstring必須

コミュニティ ID または slug。

リクエストボディ

namestring任意

コミュニティ名（必須）。50 文字以内。

joinTypestring任意

APPROVAL_REQUIRED（承認制） / FREE_JOIN（自由参加） / INVITATION_ONLY（招待制）のいずれか。

visibilitystring任意

PUBLIC / PRIVATE / LIMITED のいずれか。

descriptionstring任意

説明。500 文字以内。

languagesLanguages任意

多言語の名称・説明。

logoUrlstring任意

ロゴ画像 URL。有効な URL 形式であること。

contactContact[]任意

問い合わせ先。

tagsstring[]任意

タグ名の配列。

slugstring任意

3〜200 文字。半角英小文字・数字・ハイフン・アンダースコアのみ（^[a-z0-9-_]+$）。重複不可。

logoDarkUrlstring任意

ダークテーマ用ロゴ URL。有効な URL 形式であること。

enabledChatboolean任意

チャットを有効にするか。

customNavigationCustomNavigation任意

カスタムナビゲーション設定。

cardDesignstring | null任意

コミュニティの名刺カードのデザイン。背景画像の ID（例: solid-07-h216）か、写真を使う "custom"。"custom" は写真（cardPhoto）があるときだけ選べます。null で未設定に戻す。

cardPhotoCardPhoto | null任意

コミュニティの名刺カードに使う写真と見せ方（url・brightness・textColor の 3 つとも必要）。url は、そのコミュニティの POST /manage/communities/:id/card-photo が返した URL のみ。null で写真を削除（cardDesign が "custom" の間は削除できません）。

補足

cardDesign / cardPhoto の検証は PUT /users/me と同じです。サポートしていないデザイン ID、他のコミュニティやユーザーの写真・外部の URL、写真の無い "custom" は 400 を返します。どちらかだけ送ったときは、保存済みの設定に重ねてから確かめます。

レスポンス

Community を返します。

リクエスト
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
}'
レスポンス例
{
  "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": []
}