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