Adicionar Usuário a um Grupo
Descrição
Adiciona um usuário existente a um grupo específico, garantindo que o vínculo ainda não exista.
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": "Usuário adicionado ao grupo com sucesso."
}
Erro - 400/422 (Validação de campos)
{
"status": 422,
"error": "Os campos user_id e group_id são obrigatórios."
}
Erro - 404 (Usuário ou Grupo não encontrado)
{
"status": 404,
"error": "Usuário não encontrado."
}
{
"status": 404,
"error": "Grupo não encontrado."
}
Erro - 422 (Usuário já no grupo)
{
"status": 422,
"error": "Usuário já está neste grupo."
}
Erro - 500 (Erro interno do servidor)
{
"status": 500,
"error": "Erro ao processar a solicitação."
}
Códigos de Resposta
- 201 - Usuário adicionado ao grupo com sucesso
- 422 - Campos obrigatórios ausentes ou usuário já está no grupo
- 404 - Usuário ou grupo não encontrado
- 500 - Erro interno ao processar a solicitação