Skip to content

Troca o arquivo de uma imagem da galeria

PUT/api/upload/gallery/images/{imageId}

Auth
Requires a token
X-CommunityId
X-CommunityId Send the X-CommunityId of the community the operation happens in.
Endpoint descriptions come straight from the API specification and are in Portuguese for now. The interface around them is translated.

Multipart, campo `image` (JPEG, PNG, WebP ou GIF, até 20 MB). Mantém o id, o título e as tags; gera imagem e miniatura novas (URLs novas) e **apaga os arquivos antigos**. Mesmos papéis de quem edita a imagem: owner, admin, moderador ou o autor da imagem (403 para os demais; 404 se a imagem não é da comunidade do `X-CommunityId`). Como toda edição, devolve a imagem à moderação do space.

Parameters

NameInTypeDescription
imageIdrequiredpathstring (uuid)

Headers

NameTypeDescription
X-CommunityIdoptionalstring (uuid)ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Request body multipart/form-data

NameTypeDescription
imagerequiredstring (binary)

Responses

StatusDescription
200Arquivo trocado; devolve `id`, `imageUrl`, `thumbnailUrl`, `moderationStatus`.
400Requisição inválida — falha de validação.
401Token ausente, inválido ou expirado.
403Autenticado, mas sem permissão para esta operação.
404Recurso não encontrado.
500Erro interno do servidor.

curl example

curl -X PUT "https://api.memberfy.net/api/upload/gallery/images/<imageId>" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID" \
  -F "file=@caminho/do/arquivo"