Enviar Convite para Novo Usuário
Descrição
Envia um convite por e-mail para um novo usuário se cadastrar na plataforma SOAR. O convite é enviado usando o serviço SendGrid.
Verbo
POST
URL Base
https://api.soargi.com
Endpoint
/users/invite
Cabeçalhos
Parâmetro | Valor |
---|---|
Content-Type | application/json |
Authorization | Bearer Token |
Corpo da Requisição
{
"email": "jhon.doe@email.com",
"name": "Jhon"
}
Observação: o campo name
é opcional. Se não informado, será utilizado "Guest".
Respostas
Sucesso - 200
{
"status": "success",
"message": "Invitation successfully sent to jhon.doe@email.com"
}
Erro - 422 (E-mail inválido)
{
"status": 422,
"error": "Invalid or missing email."
}
Erro - 401 (Usuário não autenticado)
{
"status": 401,
"error": "User not authenticated."
}
Erro - 500 (Falha no envio ou processamento)
{
"status": 500,
"error": "Failed to send the invitation."
}
Códigos de Resposta
- 200 - Convite enviado com sucesso
- 422 - E-mail inválido
- 401 - Usuário não autenticado
- 500 - Falha ao enviar/processar convite