# Update details of a single user.
`PUT /admin/user/{id}`
Authentication (security requirement alternatives):
```json
[
{
"ApiKey": []
}
]
```
- ApiKey: apiKey, header X-API-Key
Parameters:
- `id` (path, integer, int64, required) - User ID
Type: integer, int64
Request body: application/json
Type: object
Schema: [User](https://sourcey-azuracast.pages.dev/docs/api/models/user/index.md)
allOf:
Reference: [HasAutoIncrementId](https://sourcey-azuracast.pages.dev/docs/api/models/hasautoincrementid/index.md); Type: object
Type: object
- `email` (optional)
Type: string
Example:
```json
"demo@azuracast.com"
```
- `auth_password` (optional)
Type: string
Example:
```json
""
```
- `name` (optional)
Type: string; nullable
Example:
```json
"Demo Account"
```
- `locale` (optional)
Type: string; nullable
Example:
```json
"en_US"
```
- `show_24_hour_time` (optional)
Type: boolean; nullable
Example:
```json
true
```
- `two_factor_secret` (optional)
Type: string; nullable
Example:
```json
"A1B2C3D4"
```
- `created_at` (optional)
Type: integer
Example:
```json
1609480800
```
- `updated_at` (optional)
Type: integer
Example:
```json
1609480800
```
- `roles` (optional)
Type: array
Items:
Type: unknown
Responses:
- 200: Success
Content type: application/json
Type: object
Schema: [Api_Status](https://sourcey-azuracast.pages.dev/docs/api/models/api-status/index.md)
- `success` (required)
Type: boolean
Example:
```json
true
```
- `message` (required)
Type: string
Example:
```json
"Changes saved successfully."
```
- `formatted_message` (required)
Type: string
Example:
```json
"Changes saved successfully."
```
- 403: Access denied.
Content type: application/json
Type: object
Schema: [Api_Error](https://sourcey-azuracast.pages.dev/docs/api/models/api-error/index.md)
- `code` (required)
Type: integer
The numeric code of the error.
Example:
```json
500
```
- `type` (required)
Type: string
The programmatic class of error.
Example:
```json
"NotLoggedInException"
```
- `message` (required)
Type: string
The text description of the error.
Example:
```json
"Error description."
```
- `formatted_message` (required)
Type: string; nullable
The HTML-formatted text description of the error.
Example:
```json
"Error description.
Detailed error text."
```
- `extra_data` (required)
Type: array
Stack traces and other supplemental data.
Items:
Type: any
- `success` (required)
Type: boolean
Used for API calls that expect an \Entity\Api\Status type response.
Example:
```json
false
```
- 404: Record not found.
Content type: application/json
Type: object
Schema: [Api_Error](https://sourcey-azuracast.pages.dev/docs/api/models/api-error/index.md)
- `code` (required)
Type: integer
The numeric code of the error.
Example:
```json
500
```
- `type` (required)
Type: string
The programmatic class of error.
Example:
```json
"NotLoggedInException"
```
- `message` (required)
Type: string
The text description of the error.
Example:
```json
"Error description."
```
- `formatted_message` (required)
Type: string; nullable
The HTML-formatted text description of the error.
Example:
```json
"Error description.
Detailed error text."
```
- `extra_data` (required)
Type: array
Stack traces and other supplemental data.
Items:
Type: any
- `success` (required)
Type: boolean
Used for API calls that expect an \Entity\Api\Status type response.
Example:
```json
false
```
- 500: A generic exception has occurred.
Content type: application/json
Type: object
Schema: [Api_Error](https://sourcey-azuracast.pages.dev/docs/api/models/api-error/index.md)
- `code` (required)
Type: integer
The numeric code of the error.
Example:
```json
500
```
- `type` (required)
Type: string
The programmatic class of error.
Example:
```json
"NotLoggedInException"
```
- `message` (required)
Type: string
The text description of the error.
Example:
```json
"Error description."
```
- `formatted_message` (required)
Type: string; nullable
The HTML-formatted text description of the error.
Example:
```json
"Error description.
Detailed error text."
```
- `extra_data` (required)
Type: array
Stack traces and other supplemental data.
Items:
Type: any
- `success` (required)
Type: boolean
Used for API calls that expect an \Entity\Api\Status type response.
Example:
```json
false
```
## Examples
### cURL
```bash
curl -X PUT 'https://demo.azuracast.com/api/admin/user/0' \
-H 'X-API-Key: YOUR_TOKEN' \
-H 'Content-Type: application/json' \
--data-raw '{
"email": "demo@azuracast.com",
"auth_password": "",
"name": "Demo Account",
"locale": "en_US",
"show_24_hour_time": true,
"two_factor_secret": "A1B2C3D4",
"created_at": 1609480800,
"updated_at": 1609480800,
"roles": []
}'
```
### JavaScript
```javascript
const body = `{
"email": "demo@azuracast.com",
"auth_password": "",
"name": "Demo Account",
"locale": "en_US",
"show_24_hour_time": true,
"two_factor_secret": "A1B2C3D4",
"created_at": 1609480800,
"updated_at": 1609480800,
"roles": []
}`;
const response = await fetch('https://demo.azuracast.com/api/admin/user/0', {
method: 'PUT',
headers: {
'X-API-Key': 'YOUR_TOKEN',
'Content-Type': 'application/json',
},
body,
});
const data = await response.text();
```
### Python
```python
import requests
body = '''{
"email": "demo@azuracast.com",
"auth_password": "",
"name": "Demo Account",
"locale": "en_US",
"show_24_hour_time": true,
"two_factor_secret": "A1B2C3D4",
"created_at": 1609480800,
"updated_at": 1609480800,
"roles": []
}'''
response = requests.put(
'https://demo.azuracast.com/api/admin/user/0',
data=body.encode('utf-8'),
headers={
'X-API-Key': 'YOUR_TOKEN',
'Content-Type': 'application/json',
},
)
print(response.text)
```