Update a specific user by id
curl --request PUT \
--url https://api.rootly.com/v1/users/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '
{
"data": {
"type": "users",
"attributes": {
"first_name": "<string>",
"last_name": "<string>",
"role_id": "<string>",
"on_call_role_id": "<string>"
}
}
}
'{
"data": {
"id": "617",
"type": "users",
"attributes": {
"name": "New Name",
"email": "[email protected]",
"phone": null,
"phone_2": null,
"first_name": "New",
"last_name": "Name",
"full_name": "New Name",
"full_name_with_team": "[Torp and Sons] New Name",
"slack_id": null,
"time_zone": "Etc/UTC",
"updated_at": "2025-12-08T21:35:12.938-08:00",
"created_at": "2025-12-08T21:35:07.894-08:00"
},
"relationships": {
"email_addresses": {
"data": [
{
"id": "aaf369e1-e3d2-4b99-8894-48a04c37f88d",
"type": "user_email_addresses"
}
]
},
"phone_numbers": {
"data": []
},
"devices": {
"data": []
},
"role": {
"data": {
"id": "44f65866-5c06-4f84-ab35-97a92c364ca3",
"type": "roles"
}
},
"on_call_role": {
"data": {
"id": "ee426b78-914f-47fe-b675-6cdc76c1d5a3",
"type": "on_call_roles"
}
},
"teams": {
"data": []
},
"schedules": {
"data": []
},
"notification_rules": {
"data": [
{
"id": "40ce1dfb-7262-4bc6-9f03-4d398b0b93cf",
"type": "user_notification_rules"
},
{
"id": "eaa08f18-4d6a-420e-b498-8a498f15d136",
"type": "user_notification_rules"
}
]
}
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Show child attributes
users update name and role simultaneously
Show child attributes
Unique ID of the user
users Show child attributes
The email of the user
Date of creation
Date of last update
First name of the user
Last name of the user
The full name of the user
The full name with team of the user
Configured time zone
Show child attributes
Was this page helpful?
curl --request PUT \
--url https://api.rootly.com/v1/users/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '
{
"data": {
"type": "users",
"attributes": {
"first_name": "<string>",
"last_name": "<string>",
"role_id": "<string>",
"on_call_role_id": "<string>"
}
}
}
'{
"data": {
"id": "617",
"type": "users",
"attributes": {
"name": "New Name",
"email": "[email protected]",
"phone": null,
"phone_2": null,
"first_name": "New",
"last_name": "Name",
"full_name": "New Name",
"full_name_with_team": "[Torp and Sons] New Name",
"slack_id": null,
"time_zone": "Etc/UTC",
"updated_at": "2025-12-08T21:35:12.938-08:00",
"created_at": "2025-12-08T21:35:07.894-08:00"
},
"relationships": {
"email_addresses": {
"data": [
{
"id": "aaf369e1-e3d2-4b99-8894-48a04c37f88d",
"type": "user_email_addresses"
}
]
},
"phone_numbers": {
"data": []
},
"devices": {
"data": []
},
"role": {
"data": {
"id": "44f65866-5c06-4f84-ab35-97a92c364ca3",
"type": "roles"
}
},
"on_call_role": {
"data": {
"id": "ee426b78-914f-47fe-b675-6cdc76c1d5a3",
"type": "on_call_roles"
}
},
"teams": {
"data": []
},
"schedules": {
"data": []
},
"notification_rules": {
"data": [
{
"id": "40ce1dfb-7262-4bc6-9f03-4d398b0b93cf",
"type": "user_notification_rules"
},
{
"id": "eaa08f18-4d6a-420e-b498-8a498f15d136",
"type": "user_notification_rules"
}
]
}
}
}
}