APIAnalytics
List tool access identities
Identities ranked by regulated or write-capable reach. Calls without a user email are left out.
GET
Identities ranked by regulated or write-capable reach. Calls without a user email are left out.
ApiKeyAuthheader
AuthorizationBearer <token>Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.
Required permission
view_user_analyticsoffset?integerNumber of items to skip before returning results.
Format
int32Range
0 <= valueDefault
0limit?integerMaximum number of items to return per page.
Format
int32Range
0 <= value <= 256Default
10start_time*stringStart of the time range to report on, inclusive.
Format
date-timeend_time*stringEnd of the time range to report on, exclusive.
Format
date-timesort?stringRanking: regulated (default) or writes.
Value in
"regulated""writes"user_email?stringRestrict to one identity.
exclude_local?booleanLeave out client built-in (local) calls.
The request has succeeded.
application/json- response
Identities ranked by tool reach.
items*array<>The items in this page.
meta*Paging information for a list response.
curl -X GET "https://example.com/analytics/tool-access/identities?start_time=2019-08-24T14%3A15%3A22Z&end_time=2019-08-24T14%3A15%3A22Z"{ "items": [ { "user_email": "string", "user_id": null, "calls": 0, "sessions": 0, "systems": 0, "regulated_systems": 0, "confidential_systems": 0, "internal_systems": 0, "operational_systems": 0, "unclassified_systems": 0, "write_systems": 0, "sensitive_calls": 0, "write_calls": 0, "top_severity": "unclassified", "has_write_chain": true } ], "meta": { "total": 0, "offset": 0, "limit": 0 }}