Skip to main content

UsageRecord

UsageRecord

type

The kind of Usage Record. agent_run for Agent Run charges, validation for Validation charges. Agent Run charges include Prompt executions and document processing. Records may be split by cost type or credit grant, so multiple agent_run records can share a run_id. New values may be added in the future.

workspace_id

agent_id

run_id

user

The user whose activity produced this Usage Record.

created

ISO 8601 timestamp indicating when this Usage Record was created.

credits_used

The credits billed for this record. For a Run’s billed total, sum credits_used across all pages of agent_run records with the same run_id, including Prompt re-executions. Filters limit which usage is included.

validation_id

ListUsageRecordsResponse

ListUsageRecordsResponse

records

The fetched page of Usage Records. A single Run can have multiple records.

total_pages

The total number of pages of Usage Records. Use the request arguments page_number and page_size to control which Usage Records are fetched.

page_number

The number of the fetched page.

page_size

The page size, i.e. number of Usage Records, fetched.