Skip to main content
GET
Get task usage by ID

Authorizations

Authorization
string
header
required

JWT authentication token

Path Parameters

task_id
string
required

The unique task identifier

Response

Task usage data

agent_triggers
integer
required

Total agent triggers

created_at
string<date-time>
required

When the task was created

model
string
required

LLM model used

status
enum<string>
required

Execution status

Available options:
completed,
error,
failed,
aborted,
blocked
step_count
integer
required

Number of steps executed

task_id
string
required

Task ID

tool_calls
integer
required

Total tool calls made

agent_breakdown
object | null

Agent trigger counts by agent name

avg_step_latency_ms
integer | null

Average step latency in milliseconds

email
string

Email of the user who created the task (only visible to team admins)

error_message
string | null

Error message if status is error

is_byok
boolean

Whether the task used a Bring Your Own Key (BYOK) provider

llm_cost
number<float> | null

LLM cost for BYOK usage. Returns the same base amount previously exposed as neo_credits.

llm_time_ms
integer | null

Total LLM inference time in milliseconds

neo_cost
number<float> | null

Neo platform cost for BYOK usage after applying neo_cost_rate

neo_credits
number<float> | null

Neo credits used

stream_count
integer

Number of streams aggregated (1 if single stream)

stream_id
string<uuid>

Stream ID (only present for individual streams, omitted for grouped tasks)

task_title
string | null

Task title when available

tool_breakdown
object | null

Tool call breakdown with calls and duration

tool_call_history
object[] | null

Detailed tool call history

tool_time_ms
integer | null

Total tool execution time in milliseconds

total_execution_ms
integer | null

Total execution time in milliseconds