Promover Guest para Individual
Descrição
Permite promover um usuário do tipo Guest para a role Individual, informando apenas o e-mail do usuário. Útil para liberar acesso completo a funcionalidades do sistema para convidados que se tornaram usuários individuais.
Verbo
POST
URL Base
https://api.soargi.com
Endpoint
/guest/promote-to-individual
Cabeçalhos
Parâmetro | Valor |
---|---|
Content-Type | application/json |
Authorization | Bearer {token} |
Esta rota exige autenticação via token JWT de convidado. O token é obtido ao validar o OTP do evento.
Corpo da Requisição
{
"email": "joao.souza@example.com"
}
O campo email
é obrigatório.
Success - 200 (OK)
{
"success": true,
"user_id": 123,
"message": "User successfully promoted to Individual."
}
Error - 404 (User not found)
{
"status": 404,
"messages": {
"error": "User not found."
}
}
Error - 400 (Required field)
{
"status": 400,
"messages": {
"error": "The email field is required."
}
}
Error - 400 (User does not have Guest profile)
{
"status": 400,
"messages": {
"error": "User does not have Guest profile. Promotion not allowed."
}
}
Error - 500 (Role not found)
{
"status": 500,
"messages": {
"error": "Role \"Guest\" or \"Individual\" not found."
}
}
Error - 401 (Missing or invalid token)
{
"success": false,
"code": 401,
"message": "Guest token missing."
}
Observações
- Atenção: Esta rota exige autenticação via token JWT de convidado (enviado no header Authorization).
Response Codes
- 200 - User successfully promoted
- 404 - User not found
- 400 - Required field missing or user is not Guest
- 500 - Role not found
- 401 - Missing or invalid token