Move a subscriber to another owner
POST
/api/v1/users/{id}/change-parent
prm_users_change_parent
Re-points the subscriber at a different owning manager. The destination must be a manager the caller may act on, because the owner is both the creditor on a debt and the revenue attribution. Naturally idempotent, so request_id is accepted for your own tracing but is not enforced.
At a glance
- Authentication
- Staff token or session
- Requires permission
-
prm_users_change_parentChange user parent - Rate limit
t_mutate
Parameters
| Parameter | Description |
|---|---|
idrequired
path · integer
|
Subscriber id. |
parent_idrequired
body · integer
|
The new owning manager. |
Errors
| Code | When it is returned |
|---|---|
ERR_VALIDATION400
|
parent_id missing or not a manager in this tenant |
ERR_NOT_FOUND404
|
the subscriber or the destination manager is outside the caller's subtree |