Geek Social — Documentação
API ReferenceCommunities

PUT /communities/:id

Atualizar comunidade

PUT/communities/:idAuth: accessToken

Atualiza os dados de uma comunidade. Requer permissão de owner ou admin.

Request

Body (JSON)

CampoTipoDescrição
namestringNome da comunidade
descriptionstringDescrição da comunidade
isPrivatebooleanSe a comunidade é privada
tagsstring[]Tags para categorizar a comunidade

Response

200

{
  "id": "uuid",
  "name": "string",
  "description": "string | null",
  "isPrivate": false,
  "tags": ["string"],
  "createdAt": "ISO 8601",
  "ownerId": "uuid"
}

Erros

CódigoDescrição
401Não autenticado
403Sem permissão (owner/admin)
404Comunidade não encontrada

Exemplos

curl -X PUT 'https://geeksocialapi.homelab-cloud.com/communities/{id}' \
  -H 'Authorization: Bearer SEU_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Novo Nome","description":"Nova descrição"}'
await fetch('https://geeksocialapi.homelab-cloud.com/communities/{id}', {
  method: 'PUT',
  headers: { Authorization: 'Bearer ' + accessToken, 'Content-Type': 'application/json' },
  body: JSON.stringify({"name":"Novo Nome","description":"Nova descrição"}),
})

On this page