Skip to main content
POST
Execute a user transfer using mappings from a scan

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
scanVersion
string
required

Token from the prior scan; rejected if stale to prevent applying an out-of-date plan.

assignments
object[]
required

Per-user transfer plan: source userId -> target department / new role / re-assignee.

deleteSourceDepartmentId
string

When set, the source department is deleted after the transfer succeeds (must be empty).

Response

Transfer accepted

transferId
string
status
string