Update a subscriber
PATCH
/api/v1/users/{id}
prm_users_update
Partial update. An omitted field is left alone. Three fields are separately permission-gated and are dropped silently rather than refused when the caller lacks the right: parent_id, profile_id and expiration.
A stored mac_locked_addrs list is inert until mac_lock_enabled is true. Writing the list alone locks nothing, which reads on screen like the lock silently failed. Set both.
At a glance
- Authentication
- Staff token or session
- Requires permission
-
prm_users_updateEdit users - Rate limit
t_mutate
Parameters
| Parameter | Description |
|---|---|
idrequired
path · integer
|
Subscriber id. |
form_name
body · string
|
Which custom-field schema to validate custom_fields against. Defaults to the user form. |
Errors
| Code | When it is returned |
|---|---|
ERR_VALIDATION400
|
bad expiration, unassignable or inactive plan, invalid allowed_services, a value Postgres itself refuses |
ERR_NOT_FOUND404
|
no such subscriber, or one outside the caller's subtree |