Skip to content

Tria um chamado (quem responde)

PATCH/api/support/tickets/{ticketId}

Auth
Requires a token
Who can call it:
owner
admin
moderator
finance
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.

Só quem **responde** a categoria do chamado: owner e admin sempre; moderador e financeiro conforme `responders` do space (a equipe fora da seleção só lê e recebe 403). Campos: `status`, `priority`, `kind`, `category`, `assigneeId` (`null` tira o responsável), `resourceId` (`null` tira), `locationText`, `title`, e `message` (resposta que acompanha `status: RESOLVED` ou `WAITING_REQUESTER`, vira uma mensagem pública). Cada campo mudado grava uma linha de histórico (`SYSTEM`). **Mudar a categoria** só para uma que quem pede também responde (senão 403). `assigneeId` precisa ser de quem responde **a categoria** (senão 400, `param: assigneeId`). Transições: de aberto para qualquer outro estado; `RESOLVED` e `CANCELED` só voltam a `OPEN` (reabrir soma `reopenedCount` se estava resolvido); transição inválida: 400. Atribuir avisa o novo responsável; resolver avisa o residente (e-mail pela fila).

Parameters

NameInTypeDescription
ticketIdrequiredpathstring (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 application/json

NameTypeDescription
statusoptionalOPEN | IN_PROGRESS | WAITING_REQUESTER | RESOLVED | CANCELED
priorityoptionalLOW | NORMAL | HIGH | URGENT
kindoptionalMAINTENANCE | REQUEST
categoryoptionalFACILITIES | CLEANING | EQUIPMENT | INTERNET | ACCESS | BILLING | OTHER
assigneeIdoptionalstring (uuid)
resourceIdoptionalstring (uuid)
locationTextoptionalstringmax 120
titleoptionalstringmax 140
messageoptionalstringmax 10000

Responses

StatusDescription
200Chamado atualizado.
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 PATCH "https://api.memberfy.net/api/support/tickets/<ticketId>" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID" \
  -H "Content-Type: application/json" \
  -d '{}'