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