PUT
/
users
/
{user}
curl --request PUT \
  --url https://api.altostrat.io/users/{user} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "email": "jsmith@example.com",
  "allow_login": true,
  "mobile": {
    "local": "<string>",
    "country": "<string>"
  },
  "timezone": "<string>",
  "date_format": "<string>",
  "time_format": "<string>",
  "roles": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "idp": "azure",
  "name": "<string>",
  "email": "jsmith@example.com",
  "email_verified": true,
  "mobile": {
    "e164": 12125551212,
    "local": "(212) 555-1212",
    "country": "US"
  },
  "mobile_verified": true,
  "allow_login": true,
  "country": "<string>",
  "timezone": "Australia/Melbourne",
  "date_format": "d M Y",
  "time_format": "H:i:s",
  "locale": "<string>",
  "picture": "<string>",
  "mfa_enabled": true,
  "roles": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Standard OAuth2 flow for user authentication. Use Authorization Code Grant or Implicit Grant. JWT Bearer tokens obtained are used for subsequent requests.

Path Parameters

​
user
string
required

UUID of the user to update.

Body

application/json
User profile information to update.

Fields for updating a user's profile. Email/Mobile changes trigger re-verification.

​
name
string
required
Maximum length: 255
​
email
string
required
Maximum length: 255
​
allow_login
boolean
required
​
timezone
string
required
​
date_format
string
required
​
time_format
string
required
​
mobile
object | null
​
roles
string[] | null

Array of Role UUIDs to assign to the user within the current team. Replaces existing roles for the team.

Response

200
application/json
User updated successfully.
​
id
string
required
​
idp
enum<string>
required

Identity provider used for login.

Available options:
azure,
saml2,
google,
github,
microsoft,
local
​
name
string
required
​
email
string
required
​
email_verified
boolean
required
​
mobile_verified
boolean
required
​
allow_login
boolean
required

Whether the user is allowed to log in.

​
timezone
string
required

User's preferred timezone identifier.

Example:

"Australia/Melbourne"

​
date_format
string
required

User's preferred date format string.

Example:

"d M Y"

​
time_format
string
required

User's preferred time format string.

Example:

"H:i:s"

​
locale
string
required

User's preferred locale (e.g., en).

​
picture
string
required

URL to the user's profile picture.

​
mfa_enabled
boolean
required

Whether the user has enabled Multi-Factor Authentication.

​
roles
object[]
required

List of role IDs assigned to the user in the current team.

​
mobile
object
​
country
string | null

User's country code (ISO2).

Was this page helpful?