PATCH
/
users
/
{userId}
Updates a user
curl --request PATCH \
  --url https://api.eu.bronto.io/users/{userId} \
  --header 'Content-Type: application/json' \
  --header 'X-BRONTO-API-KEY: <api-key>' \
  --data '{
  "first_name": "Alice",
  "last_name": "Smith",
  "roles": [
    "Admin",
    "Standard",
    "ReadOnly"
  ],
  "login_methods": {}
}'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "first_name": "John",
  "last_name": "Doe",
  "email": "john@company.com",
  "roles": [
    "ReadOnly",
    "Standard"
  ],
  "last_logins": {
    "Okta": 1731370728,
    "Password": 1731338939
  },
  "login_methods": {},
  "tags": {
    "region": "eu",
    "environment": "production"
  }
}

Authorizations

X-BRONTO-API-KEY
string
header
required

Path Parameters

userId
string<uuid>
required

Unique identifier of the user to update

Body

application/json
first_name
string

The user's first name

Required string length: 1 - 255
Example:

"Alice"

last_name
string

The user's last name

Required string length: 1 - 255
Example:

"Smith"

roles
string[]

A list of role ids

Example:
["Admin", "Standard", "ReadOnly"]
login_methods
object

Response

User updated successfully

id
string<uuid>
required

The unique identifier for the user

first_name
string
required

The user's first name

Example:

"John"

last_name
string
required

The user's last name

Example:

"Doe"

email
string<email>
required

The user's email address

Example:

"john@company.com"

roles
string[]

A list of role ids

Example:
["ReadOnly", "Standard"]
last_logins
object

A map of login methods to their last login timestamps (Unix epoch).

Example:
{
"Okta": 1731370728,
"Password": 1731338939
}
login_methods
object
tags
object

A map of key value pairs associated with this log

Example:
{
"region": "eu",
"environment": "production"
}