/billing

Get Agent Composer Step Usage

Changed on

Get Agent Composer step-level usage data for a specific month.

This API returns daily usages of advance queries grouped by steps. The data is used for visualization purposes to show users which Agent Composer steps were executed and their associated costs and token consumption.

Note: The costs returned here are already included in the ACL_COST entry from the daily_usages table and should not be double-counted in billing.

Args: request: Request object containing year, month, and optional resource_id user_context: User context with tenant admin permissions

Returns: Agent Composer step usage data aggregated by step and date

get/billing/usages/acl

Request

  • Base URL
    https://api.contextual.ai/v1
  • URL
    https://api.contextual.ai/v1/billing/usages/acl
  • Auth
    HTTP bearer

Query parameters

yearinteger required
monthinteger required
resource_idstring uuid nullable

Response

Successful Response

Changes