Skip to main content
POST
/
api
/
departments
/
transfer
/
scan
Deep scan dependencies for a single-user department transfer
curl --request POST \
  --url https://your-instance.example.com/api/departments/transfer/scan \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "userId": "65b1f0a2c3d4e5f6a7b8c9d0",
  "targetDepartmentId": "65c1a0b0c0d0e0f0a0b0c0d1"
}
'
{
  "scanVersion": "v2026-05-18T12:00:00Z-abc123",
  "summary": {
    "prompts": 4,
    "automations": 2,
    "conversations": 17,
    "approvalPolicies": 1
  },
  "conflicts": []
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
userId
string
required

User _id being moved out of their current department.

​
targetDepartmentId
string
required

Destination department _id the user should be reassigned to.

Response

Scan completed

The response is of type object.