Microsoft Entra Deprovision User

arazzo: 1.0.1
info:
  title: Microsoft Entra Deprovision User
  summary: Disable a user account, then delete the user from the directory.
  description: >-
    Safely deprovisions a user in Microsoft Entra ID by first patching the
    account to set accountEnabled to false (immediately blocking sign-in) and
    then deleting the user object, which moves it to the deletedItems container
    where it can be restored within 30 days. Disabling before deleting ensures
    access is revoked even if the delete is delayed. Every request is inlined so
    the chain reads end to end.
  version: 1.0.0
  x-realizes-capability-ids:
  - BC-620.20
  x-capability-derivation:
    method: 'deterministic join: sourceDescriptions -> per-tag OpenAPI -> tag/capability edge. No classification at this step.'
    min_confidence: 0.7
    sources:
    - capability_id: BC-620.20
      capability_name: Identity & Access Management
      spec: microsoft-entra-users-api-openapi.yml
      confidence: 0.85
    model: Turbo EA Capabilities by Vincent Verdet — Turbo EA, https://github.com/vincentmakes/turbo-ea-capabilities, CC BY 4.0
sourceDescriptions:
- name: usersApi
  url: ../openapi/microsoft-entra-users-api-openapi.yml
  type: openapi
workflows:
- workflowId: deprovision-user
  summary: Disable a user account then delete it (soft-delete to deletedItems).
  description: >-
    Sets accountEnabled to false to block sign-in, then deletes the user
    object, moving it to the recoverable deletedItems container.
  inputs:
    type: object
    required:
    - accessToken
    - userId
    properties:
      accessToken:
        type: string
        description: OAuth 2.0 bearer token with User.ReadWrite.All.
      userId:
        type: string
        description: Object id or userPrincipalName of the user to deprovision.
  steps:
  - stepId: disableUser
    description: >-
      Disable the account by setting accountEnabled to false. Returns 204 with
      no body.
    operationId: updateUser
    parameters:
    - name: Authorization
      in: header
      value: "Bearer $inputs.accessToken"
    - name: user-id
      in: path
      value: $inputs.userId
    requestBody:
      contentType: application/json
      payload:
        accountEnabled: false
    successCriteria:
    - condition: $statusCode == 204
    outputs:
      disableStatus: $statusCode
  - stepId: deleteUser
    description: >-
      Delete the user object, moving it to the deletedItems container for
      possible restore within 30 days.
    operationId: deleteUser
    parameters:
    - name: Authorization
      in: header
      value: "Bearer $inputs.accessToken"
    - name: user-id
      in: path
      value: $inputs.userId
    successCriteria:
    - condition: $statusCode == 204
    outputs:
      deleteStatus: $statusCode
  outputs:
    disableStatus: $steps.disableUser.outputs.disableStatus
    deleteStatus: $steps.deleteUser.outputs.deleteStatus