Adicionar Usuário a um Grupo
Descrição
Adiciona um usuário existente a um grupo específico, criando o vínculo somente se ainda não existir.
Verbo
POST
URL Base
https://api.soargi.com
Endpoint
/groups/add-user
Cabeçalhos
Parâmetro | Valor |
---|---|
Content-Type | application/json |
Authorization | Bearer Token |
Corpo da Requisição
{
"user_id": 1,
"group_id": 5
}
Sucesso - 201 (Usuário adicionado)
{
"status": "success",
"message": "User successfully added to the group."
}
Erro - 422 (Validação de campos)
{
"status": 422,
"error": "The fields user_id and group_id are required."
}
{
"status": 422,
"error": "User is already a member of this group."
}
Erro - 404 (Usuário ou Grupo não encontrado)
{
"status": 404,
"error": "User not found."
}
{
"status": 404,
"error": "Group not found."
}
Erro - 500 (Erro interno do servidor)
{
"status": 500,
"error": "Failed to process the request."
}
Códigos de Resposta
- 201 - Usuário adicionado ao grupo com sucesso
- 422 - Campos obrigatórios ausentes ou usuário já é membro do grupo
- 404 - Usuário ou grupo não encontrado
- 500 - Erro inesperado ao adicionar usuário ao grupo