TaskCall User API Calls
User API calls are used to retrieve details of users of an organization. They are an extension to the Incidents API. This documentation contains the schema for making the calls. The calls are subjected to the permissions your organization account has. If your organization does not have the right permissions, then a permission error will be thrown. The same applies for some of the optional fields of the calls.
If this is your first time using the Incidents API, then please refer to the Incidents API Basic Pointers to get started.
User List
Get the list of users of an organization.
/users/list
POST
None
- team_ref_id: (string) ID of the team to filter by.
- keywords: (string) Search keywords to filter by.
JSON response
[
{
"preferred_username":"adsmi",
"display_name":"Adam Hoffman Smith",
"email":"***@apollo.com",
"user_role":"OWNER",
"job_title":"CTO",
"is_locked":false
},
...
]
User Details
Get the details of a user.
/users/details
POST
- preferred_username: (string) Preferred username of the user.
JSON response
{
"email":"***@apollo.com",
"first_name":"Ashley",
"last_name":"Haining",
"iso_country_code":"US",
"country_code":"1",
"phone":"***",
"preferred_username":"ashai",
"taskcall_email":"***@apollo.taskcallapp.com",
"timezone":"US/Eastern",
"language":"en",
"profile_picture":"***",
"user_role":"ADMIN",
"job_title":"IT Manager",
"tags":[]
}