Get task usage by ID
Get detailed usage data for a specific task by its ID. Returns aggregated metrics across all streams within this task, including token counts, costs, tool calls, and execution times.
Access control:
- Solo users (not in a team): Can view their own tasks only
- Team admins: Can view any team member’s tasks
- Team members/viewers: No access (returns 403)
Authorizations
JWT authentication token
Path Parameters
The unique task identifier
Response
Task usage data
Total agent triggers
When the task was created
LLM model used
Execution status
completed, error, failed, aborted, blocked Number of steps executed
Task ID
Total tool calls made
Agent trigger counts by agent name
Average step latency in milliseconds
Email of the user who created the task (only visible to team admins)
Error message if status is error
Whether the task used a Bring Your Own Key (BYOK) provider
LLM cost for BYOK usage. Returns the same base amount previously exposed as neo_credits.
Total LLM inference time in milliseconds
Neo platform cost for BYOK usage after applying neo_cost_rate
Neo credits used (1 credit = $10 USD equivalent)
Number of streams aggregated (1 if single stream)
Stream ID (only present for individual streams, omitted for grouped tasks)
Task title when available
Tool call breakdown with calls and duration
Detailed tool call history
Total tool execution time in milliseconds
Total execution time in milliseconds

