Reenviar convite

POST/functions/v1/api?route=integracao

action usuario-reconvidarBearer token

Somente vínculos pendentes ou revogados. O novo convite vence em sete dias e é enviado apenas ao e-mail já registrado. Recontratado precisa aceitar novamente. Vínculo ativo retorna 409; inexistente, 404.

idempotencyKey é obrigatória: 16 a 128 letras, números, hífen ou underscore. Repetições do mesmo evento usam a mesma chave. Um novo evento usa chave nova. O replay retorna replayed: true, sem outro envio e sem campo emailSent.

Parâmetros do corpo

actionstringobrigatório

Operação executada. Valor fixo desta página. usuario-reconvidar

externalIdstringobrigatório

Identificador estável e único por empresa. Nunca reutilize para outra pessoa.

idempotencyKeystringobrigatório

Identificador do evento, estável nos retries. De 16 a 128 letras, números, hífen ou underscore.

Corpo da requisição

json

{
  "action": "usuario-reconvidar",
  "externalId": "RH-12345",
  "idempotencyKey": "evento-rh-20261019-12345"
}

Resposta

json

{
  "usuario": {
    "id": "11111111-1111-4111-8111-111111111111",
    "empresa_id": "22222222-2222-4222-8222-222222222222",
    "usuario_id": null,
    "email": "pessoa@example.com",
    "nome": "Pessoa da equipe",
    "status": "pendente",
    "permissions": {
      "avaliacoes": "leitura",
      "riscos": "nenhum",
      "epi": "nenhum"
    },
    "external_id": "RH-12345"
  },
  "emailSent": true,
  "replayed": false
}

emailSent: true significa aceitação pelo provedor, não entrega na caixa de entrada. O link do convite não é devolvido à integração. Se emailSent for false, corrija a causa e use um novo evento de reconvite.