post
https://production-api.shoutaboutus.com/api/v1/user/edit
Update an existing account user's name/title, role, store assignments, optional password and deactivation date. You cannot edit your own account. Password changes revoke the target's live tokens and are audited. The target must belong to the caller's account company.
Auth
- Account admin — collection bearer token.
authorizerequires caller companybundle_id=BRAND, the target in the same company, and the target ≠ self (else403).
Rate limit
- No rate limit.
Body
| Field | Type | Required | Notes |
|---|---|---|---|
user | integer | Required | Id of the user to edit. |
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. |
user_type | string | Required | admin, location_assign, or basic. |
store_ids | integer[] | Required if user_type=location_assign, or basic with assign_all_accounts=0 | Store ids under the caller's account. |
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. |
Behaviour
- Synchronous (DB transaction).
200on success. 403when authorize fails (not an account / target not in company / editing self).422on validation failure;500on save failure (rolled back).
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…