DepartmentTransfer

Execute a user transfer using mappings from a scan

POST
/api/departments/transfer/execute

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  }}