Adicionar cliente a um grupo

PATCH

/groups/{groupId}/clients/{clientId}/add

Vincula o cliente informado em clientId ao grupo informado em groupId. Se o cliente já pertencia a outro grupo, ele é retirado do grupo anterior. Cliente inexistente, grupo inexistente e cliente que já está no grupo devolvem 400. A resposta não tem corpo. Requer autenticação via Bearer JWT ou header x-api-key.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Parâmetros Header

Respostas

🟢200

application/json

Cliente vinculado ao grupo

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠400Vínculo recusado

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/groups/f1a2b3c4-0000-4000-8000-000000000901/clients/7c9e6679-7425-40de-944b-e07fc1f90ae7/add' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Exemplo 1

{}

Modificado em 2026-10-13 09:47:06

Página anterior

Remover grupo

Próxima página

Remover cliente de um grupo