Overview
Reference
- AlertEvents
- AlertGroups
- AlertUrgencies
- AlertSources
- Alerts
- Audits
- Authorizations
- CatalogEntities
- CatalogEntityProperties
- CatalogFields
- Catalogs
- Causes
- [DEPRECATED] CustomFieldOptions
- [DEPRECATED] CustomFields
- CustomForms
- DashboardPanels
- Dashboards
- Environments
- EscalationPolicies
- EscalationLevelsPolicies
- EscalationLevelsPath
- EscalationLevels
- EscalationPaths
- FormFieldOptions
- FormFieldPlacementConditions
- FormFieldPlacements
- FormFieldPositions
- FormFields
- FormSetConditions
- FormSets
- Functionalities
- WorkflowTasks
- [DEPRECATED] WorkflowCustomFieldSelections
- WorkflowFormFieldConditions
- WorkflowGroups
- WorkflowRuns
- Workflows
- Heartbeats
- IncidentActionItems
- [DEPRECATED] IncidentCustomFieldSelections
- IncidentEventFunctionalities
- IncidentEventServices
- IncidentEvents
- IncidentFeedbacks
- IncidentFormFieldSelections
- IncidentPermissionSetBooleans
- IncidentPermissionSetResources
- IncidentPermissionSets
- IncidentRetrospectives
- IncidentRetrospectiveSteps
- IncidentRoleTasks
- IncidentRoles
- IncidentStatusPageEvents
- IncidentSubStatuses
- IncidentTypes
- Incidents
- IpRanges
- LiveCallRouters
- OnCallRoles
- OnCallShadows
- OverrideShifts
- PlaybookTasks
- Playbooks
- RetrospectiveTemplates
- Pulses
- RetrospectiveConfigurations
- RetrospectiveProcessGroupSteps
- RetrospectiveProcessGroups
- RetrospectiveProcesses
- RetrospectiveSteps
- Roles
- ScheduleRotationActiveDays
- ScheduleRotationUsers
- ScheduleRotations
- Schedules
- Shifts
- Secrets
- Services
- Severities
- StatusPageTemplates
- StatusPages
- SubStatuses
- Teams
- UserNotificationRules
- Users
- WebhooksDeliveries
- WebhooksEndpoints
Users
Retrieves an user
Users
Retrieves an user
Retrieves a specific user by id
GET
/
v1
/
users
/
{id}
curl --request GET \
--url 'https://api.rootly.com/v1/users/%7Bid%7D?include=SOME_STRING_VALUE' \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN'
{
"data": {
"id": "510",
"type": "users",
"attributes": {
"name": "Forrest Fritsch",
"email": "napoleon.pouros@greenholt.test",
"phone": null,
"phone_2": null,
"full_name": "Forrest Fritsch",
"full_name_with_team": "[Walker-Koelpin] Forrest Fritsch",
"slack_id": null,
"time_zone": "UTC",
"updated_at": "2025-03-05T15:13:50.794-08:00",
"created_at": "2025-03-05T15:13:46.433-08:00"
},
"relationships": {
"email_addresses": {
"data": [
{
"id": "94e3ef1d-af4b-41ec-ae1b-0ccf37bd538e",
"type": "user_email_addresses"
}
]
},
"phone_numbers": {
"data": []
},
"devices": {
"data": []
}
}
}
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
Query Parameters
comma separated if needed. eg: email_addresses,phone_numbers
Available options:
email_addresses
, phone_numbers
, devices
Response
200
application/vnd.api+json
user found
Unique ID of the user
Available options:
users
The email of the user
Date of creation
Date of last update
The full name of the user
The full name with team of the user
Configured time zone
Was this page helpful?
curl --request GET \
--url 'https://api.rootly.com/v1/users/%7Bid%7D?include=SOME_STRING_VALUE' \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN'
{
"data": {
"id": "510",
"type": "users",
"attributes": {
"name": "Forrest Fritsch",
"email": "napoleon.pouros@greenholt.test",
"phone": null,
"phone_2": null,
"full_name": "Forrest Fritsch",
"full_name_with_team": "[Walker-Koelpin] Forrest Fritsch",
"slack_id": null,
"time_zone": "UTC",
"updated_at": "2025-03-05T15:13:50.794-08:00",
"created_at": "2025-03-05T15:13:46.433-08:00"
},
"relationships": {
"email_addresses": {
"data": [
{
"id": "94e3ef1d-af4b-41ec-ae1b-0ccf37bd538e",
"type": "user_email_addresses"
}
]
},
"phone_numbers": {
"data": []
},
"devices": {
"data": []
}
}
}
}