List all stream usages
List usage data for individual streams. Each stream represents a single execution within a task. Use this endpoint for detailed per-stream analysis including cost, tool calls, and execution metrics. For aggregated task-level data, use GET /api/v1/usage/tasks instead.
Access control:
- Solo users (not in a team): Can view their own streams only
- Team admins: Can view all team members’ streams (with email field and optional email filter)
- Team members/viewers: No access (returns 403)
Authorizations
JWT authentication token
Query Parameters
Filter by task ID
Filter by specific stream ID
Filter by status
completed, error, failed, aborted, blocked Filter by model
Filter from datetime (ISO 8601)
Filter to datetime (ISO 8601)
Number of results (1-200, default 50)
1 <= x <= 200Pagination offset (default 0)
x >= 0Sort field
created_at, cost Filter by team member email (exact match, only for team admins)
Filter by BYOK status (true = only BYOK streams, false = only non-BYOK streams)

