ChatGPT ↗
Claude ↗This page documents the canonical HTTP contract for this endpoint.
This route validates that the destination owner is an active CRM owner in the authenticated organization and applies the reassignment synchronously. The response reports modified_count as updated_count; repeating the same owner may produce updated_count 0. Selection is restricted to the authenticated organization.
Body parameters
user_idrequiredstring
Destination owner user ID.
lead_ids· optionalarray<string>
Explicit Lead IDs; use this or selection.
selection· optionalobject
BulkSelectionModel: {mode: "ids", ids: [...]} or {mode: "descriptor", descriptor: {root: <FilterNode>}}. Descriptor root is a rule or group with kind, field/operator/value or logic/children.
scope· optionalstring
Lead scope.
source_table_id· optionalstring
Research table context.
source_table_scope· optionalstring
Research table scope.
| Name | Type | Description |
|---|---|---|
| user_idrequired | string | Destination owner user ID. |
| lead_ids | array<string> | Explicit Lead IDs; use this or selection. |
| selection | object | BulkSelectionModel: {mode: "ids", ids: [...]} or {mode: "descriptor", descriptor: {root: <FilterNode>}}. Descriptor root is a rule or group with kind, field/operator/value or logic/children. |
| scope | string | Lead scope. |
| source_table_id | string | Research table context. |
| source_table_scope | string | Research table scope. |
Errors
| Status | Meaning |
|---|---|
| 400 | Provide a valid selection and owner user ID. |
| 401 | Invalid API key or missing auth. |
| 403 | Missing leads:write scope. |