ورود | ثبت نام
- FA
- EN
Update the information of a specific user.
| Permission | Description |
|---|---|
users.update_any | Update any user as an admin |
| Name | Type | Required | Description |
|---|---|---|---|
first_name | string | No | First name (max 255) |
last_name | string | No | Last name (max 255) |
email | string | No | Email (max 255, unique) |
phone | string | No | Phone number (unique, E.164 format) |
bank_account_number | string | No | Bank account number (max 50 characters, nullable) |
username | string | No | Username (max 255, unique) |
height | integer | No | User's height in CM |
birth_date | date | No | User's birth date |
gender | string | No | User's gender (male, female, other) |
password | string | No | New password (will be hashed) |
trainer_license_image | null | No | Only null is accepted, which clears the license. Any other value is rejected with 422 — uploads go through Create Media with purpose=trainer_license |
trainer_license_approved | boolean|null | No | The review decision: true approves, false rejects, null returns the user to pending |
trainer_license_rejection_reason | string|null | No | Reason shown to the user when rejected (max 1000) |
All parameters are optional. If omitted, they will not be updated.
Setting trainer_license_approved to a non-null value that differs from the user's current decision sends them a TrainerLicenseReviewedNotification (see Notifications). Re-sending the same decision is a no-op and notifies nobody.
Clearing trainer_license_image deletes the stored document and resets both trainer_license_approved and trainer_license_rejection_reason to null, unless the same request sets them explicitly.
Returns the updated user resource.
{
"data": { /* user resource */ }
}
See User Resource.
| Status | Description | Reference |
|---|---|---|
| 404 | User not found | Not-found error |
| 409 | Email or phone already in use | |
| 422 | Validation error | Validation error |
| 401 | Unauthorized | Authentication error |
| 403 | Forbidden | Permission error |
