Skip to main content
GET
Get top agents by recent activity
Supply timezone, optional days (default 7, maximum 90), and limit (default 4, maximum 20). This endpoint uses a lookback window; use the extended ranking for a custom date range.

Authorizations

Authorization
string
header
required

Bandwidth Labs OAuth access token. Uses the user's selected workspace; the workspace header is not required. Do not also send an API key. Bearer-only operations may additionally require the Labs super_user role.

Headers

X-VOAI-ORGANIZATION-ID
string | null

Required with X-BW-LABS-AGENTS-API-KEY: the positive local workspace ID to access. The key owner must be a current member. Missing or invalid IDs return 400; non-member workspaces return 403. Not required for bearer authentication, which uses the user's selected workspace.

Query Parameters

timezone
string
required

IANA timezone (e.g., 'America/New_York')

days
integer
default:7

Lookback window in days

Required range: 1 <= x <= 90
limit
integer
default:4

Max results

Required range: 1 <= x <= 20

Response

Successful Response

run_count
integer
required
workflow_id
integer
required
workflow_name
string
required