Sign in
Agents

Get agent usage

Changed on

Tallies this agent's model token usage and provider-reported cost, broken down by configured model. Optionally limits the tally to a time window.

get/orgs/{orgID}/projects/{projectID}/agents/{agentID}/usage

Request

  • Base URL: https://api.omnara.com/v1
  • URL: https://api.omnara.com/v1/orgs/{orgID}/projects/{projectID}/agents/{agentID}/usage
  • Auth: one of:
    • HTTP bearer
    • API key in cookie __Host-omnara_session

Query parameters

sincestring date-time

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

untilstring 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_subagentsboolean

Also include usage from this agent's subagents at every depth. Defaults to false.

Response

Usage totals for the agent.

Changes