Skip to main content
GET
Get agent profile usage

Authorizations

Authorization
string
header
required

An opaque Omnara personal or organization bearer token.

Path Parameters

orgID
string
required
Pattern: ^org_[a-z2-7]{26}$
projectID
string
required
Pattern: ^proj_[a-z2-7]{26}$
agentProfileID
string
required
Pattern: ^aprf_[a-z2-7]{26}$

Query Parameters

since
string<date-time>

Only tally model calls started at or after this instant. Omit to start from the earliest recorded call.

until
string<date-time>

Only tally model calls started before this instant. Must be later than since when both are given. Omit to include calls up to now.

include_subagents
boolean

Also include usage from subagents spawned, at every depth, by agents launched from this profile. Defaults to false.

Response

Usage totals for the agent profile.

totals
object
required
by_model
object[]
required

Per-model rows ordered by provider config name, configured model name, then provider model slug. Models with distinct provider slugs across revisions appear once per slug.