API Documentation
Endpoints
- Breaches
- Simulation
- Awareness
- General
Get employee details
Retrieves details for a specific employee by ID.
curl --request GET \
--url https://public-api.tryriot.com/v1/employees/{employee_id} \
--header 'x-api-key: <api-key>'
{
"data": {
"country_code": "FR",
"created_at": "2024-01-13T10:00:00.000000Z",
"department": {
"name": "Devs"
},
"email_addresses": [
{
"address": "[email protected]",
"is_primary": true,
"source": "google"
}
],
"id": "e4ebfd69-3c2c-4028-b423-1bff3d87d58f",
"job_title": "Account manager",
"karma": {
"score": 500,
"security_level": "dangerous"
},
"language": "english",
"manager": {
"id": "e4ebfd69-3c2c-4028-b423-1bff3d87d58f",
"name": "John Doe",
"primary_email_address": "[email protected]"
},
"name": "John Doe",
"primary_email_address": "[email protected]",
"status": "active",
"timezone": "Europe/Paris",
"updated_at": "2024-01-13T10:00:00.000000Z",
"workspace": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}
}
Authorizations
Path Parameters
ID of the employee to retrieve
Response
Alpha-2 ISO 3166-1 country code of the employee.
2
"FR"
Riot employee creation date
"2024-01-13T10:00:00.000000Z"
Name of the department
"Devs"
Professional email addresses of the employee. No personal email address is returned
Email address
Source of the email.
custom
- the email is provided by the employee's admin or set during CSV import
employee
- the email is provided by the employee via portal
google
, microsoft
, okta
, slack
- imported via corresponding synchronization
custom
, employee
, google
, microsoft
, okta
, slack
"google"
UUID of the employee
"e4ebfd69-3c2c-4028-b423-1bff3d87d58f"
The employee's job title.
"Account manager"
Language of the employee
english
, german
, spanish
, french
, italian
, japanese
, korean
, dutch
, portuguese_brazilian
, chinese
, portuguese
, greek
, romanian
, polish
, ukrainian
, slovenian
, danish
, finnish
, turkish
, norwegian_bokmal
"english"
UUID of the employee
"e4ebfd69-3c2c-4028-b423-1bff3d87d58f"
Name of the employee
"John Doe"
Email address
Name of the employee
"John Doe"
Primary email address of the employee
active
, deactivated
, pending
Timezone of the employee.
"Europe/Paris"
When the last update occurred
"2024-01-13T10:00:00.000000Z"
curl --request GET \
--url https://public-api.tryriot.com/v1/employees/{employee_id} \
--header 'x-api-key: <api-key>'
{
"data": {
"country_code": "FR",
"created_at": "2024-01-13T10:00:00.000000Z",
"department": {
"name": "Devs"
},
"email_addresses": [
{
"address": "[email protected]",
"is_primary": true,
"source": "google"
}
],
"id": "e4ebfd69-3c2c-4028-b423-1bff3d87d58f",
"job_title": "Account manager",
"karma": {
"score": 500,
"security_level": "dangerous"
},
"language": "english",
"manager": {
"id": "e4ebfd69-3c2c-4028-b423-1bff3d87d58f",
"name": "John Doe",
"primary_email_address": "[email protected]"
},
"name": "John Doe",
"primary_email_address": "[email protected]",
"status": "active",
"timezone": "Europe/Paris",
"updated_at": "2024-01-13T10:00:00.000000Z",
"workspace": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}
}