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