Configurar a propriedade employeeLeaveDateTime para um usuário

Este artigo descreve como configurar o atributo employeeLeaveDateTime para um usuário. Essa propriedade pode ser usada como um gatilho para fluxos de trabalho "leaver" criados usando fluxos de trabalho do ciclo de vida.

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões privilegiadas mais altas
Delegado (conta corporativa ou de estudante) User.Read.All e User-LifeCycleInfo.ReadWrite.All Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo User.Read.All e User-LifeCycleInfo.ReadWrite.All Indisponível.

Para cenários delegados, o administrador também deve ter a função administrador global Microsoft Entra.

Observação

Essas informações são melhor atualizadas por meio da automação usando uma solução de provisionamento de RH, Microsoft Entra Connect ou sincronização personalizada. Para obter mais informações sobre esse processo, consulte Como sincronizar atributos para fluxos de trabalho do ciclo de vida.

Solicitação

O exemplo a seguir configura 30 de setembro de 2022 às 23:59 como a data e hora em que o usuário deixará a organização.

PATCH https://graph.microsoft.com/v1.0/users/df744d9e-2148-4922-88a8-633896c1e929

{
    "employeeLeaveDateTime": "2022-09-30T23:59:59Z"
}