Count active agent instances
Count of distinct agent instances with activity in the given time range.
Count of distinct agent instances with activity in the given time range.
ApiKeyAuthAuthorizationBearer <token>Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.
Required permission
view_agent_analyticsscope?stringown returns only the caller's own records, even when they may see the whole organization. all, the default, returns everything the caller may see. It never widens what the caller may see.
"all""own"start_time*stringStart of the time range to report on, inclusive.
date-timeend_time*stringEnd of the time range to report on, exclusive.
date-timeagent_slug?array<string>Filter to agents by slug, the agent type such as claude-code.
user_id?array<>Filter to specific users by id.
user_group?array<string>Filter to users in specific groups.
agent_tag_id?array<>Filter to agent instances carrying specific tags.
resource_tag_id?array<>Filter to MCP servers carrying specific tags.
The request has succeeded.
application/json- response
Count of distinct active agent instances in a time range.
count*integerNumber of distinct agent instances with activity.
int64curl -X GET 'https://your-org.aisecurity.services.us.connect.secureauth.com/api/v1/analytics/active-agent-instances?start_time=2019-08-24T14%3A15%3A22Z&end_time=2019-08-24T14%3A15%3A22Z'{ "count": 0}