DepartmentTransfer
Execute a user transfer using mappings from a scan
Apply the assignments returned by /scan or /scan-bulk. The supplied scanVersion must still match the live state - a stale scan returns 400 and the caller must re-scan. Optionally deletes the source department after a successful bulk move. Returns 202 with a transferId for status polling.
Authorization
bearerAuth AuthorizationBearer <token>
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/departments/transfer/execute" \ -H "Content-Type: application/json" \ -d '{ "scanVersion": "v2026-05-18T12:00:00Z-abc123", "assignments": [ { "userId": "65b1f0a2c3d4e5f6a7b8c9d0", "targetDepartmentId": "65c1a0b0c0d0e0f0a0b0c0d1" } ], "deleteSourceDepartmentId": "65c1a0b0c0d0e0f0a0b0c0d0" }'{ "transferId": "65d0a0b0c0d0e0f0a0b0c0d0", "status": "running", "progress": { "processed": 5, "total": 24 }}