Skip to main content
Proxied do WorkOS — nao e armazenado no banco de dados da aplicacao.

​
Esquema

CampoTipoDescricao
invitationIdstringIdentificador unico (formato WorkOS: inv_*)
organizationIdUUIDv7FK para Organization
inviterUserIdstring?ID do usuario que convidou
acceptedUserIdstring?ID do usuario que aceitou
emailstringEmail do convidado
tokenstringToken do convite
acceptInvitationUrlstringURL de aceitacao
roleSlugstring?Role ao aceitar
stateenumPENDING, ACCEPTED, REVOKED, EXPIRED
expiresAtdatetimeExpiracao
acceptedAtdatetime?Momento da aceitacao
revokedAtdatetime?Momento da revogacao
createdAtdatetimeTimestamp de criacao
updatedAtdatetimeUltima atualizacao

​
Exemplo

{
  "invitationId": "inv_01JK8INVITE12345ABCDE",
  "organizationId": "019525fd-8b21-7d3c-a1f5-3c7e9b1d5f8a",
  "inviterUserId": "019525fd-7e40-7c5a-b2d8-4e6f8a0c2e4a",
  "acceptedUserId": null,
  "email": "maria.santos@techbrasil.com.br",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "acceptInvitationUrl": "https://studio.awsales.io/invite/eyJhbGciOiJIUzI1NiIs...",
  "roleSlug": "member",
  "state": "PENDING",
  "expiresAt": "2026-04-09T10:30:00Z",
  "acceptedAt": null,
  "revokedAt": null,
  "createdAt": "2026-04-02T10:30:00Z",
  "updatedAt": "2026-04-02T10:30:00Z"
}

​
Relacionamentos

​
Transicoes de Estado

​
Regras de Negocio

  • Email unico por organizacao
  • So pode revogar/reenviar se PENDING
  • Magic link OTP pode validar e aceitar
  • Expiracao automatica
Convites so podem ser revogados ou reenviados enquanto estiverem no estado PENDING. Uma vez ACCEPTED, REVOKED ou EXPIRED, o convite e imutavel.
Ao aceitar um convite, uma Membership e criada automaticamente vinculando o usuario a organizacao com a role especificada em roleSlug.
O campo token e um JWT de uso unico gerado pelo WorkOS. A URL de aceitacao (acceptInvitationUrl) redireciona para o fluxo de autenticacao do studio.