post
https://production-api.shoutaboutus.com/api/v1/users/partner/edit
Update an existing partner user's name/title, role, account assignments, optional password and deactivation date. Password changes and deactivations revoke the target's live tokens (SOC 2 CC6.2) and are audited. The target must belong to the caller's company.
Auth
- Partner — collection bearer token. In-controller gate: the target's
company_idmust equal the caller's, else403 Permission denied.
Rate limit
- No rate limit.
Body
| Field | Type | Required | Notes |
|---|---|---|---|
user | integer | Required | Id of the user to edit. |
user_type | string | Required | admin, assign_brand, or basic. |
first_name | string | Required | ≤255 chars; no angle brackets. |
last_name | string | Optional | ≤255 chars. |
title | string | Optional | ≤50 chars. |
password | string | Optional | 8–100 chars, complexity rules; blank leaves the password unchanged. Changing it revokes the user's tokens. |
account | integer[] | Required if user_type=assign_brand, or basic with assign_all_accounts=0 | Account company ids under the caller. |
assign_all_accounts | integer | Required if user_type=basic | 0/1. |
send_default_reports | integer | Optional | 0/1. |
inactive_at | string | Optional | Y-m-d H:i:s; setting a past/imminent date deactivates the user and revokes their tokens. |
Behaviour
- Synchronous (DB transaction).
200on success. 403when the target is not in the caller's company (Permission denied.).422on validation failure;500on save failure.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…