API Reference
Log In
API Reference

Meter Tool Event

Submit tool/function call metadata for metering and billing purposes.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Tool event metadata including tool ID, operation, duration, and attribution

The tool event metadata

string | null

Unique identifier for this tool call transaction

string
required
length ≥ 1

Identifier of the tool being called

string | null

The specific operation being performed by the tool

int64

Duration of the tool call in milliseconds

boolean

Whether the tool call was successful

string | null

Error message if the tool call failed

double | null

Cost of the tool call in USD. When provided, this value overrides the tool's configured pricing and is used directly as the charge. When omitted, the charge comes from the price you set for this tool in Revenium.

string
required
length ≥ 1

ISO 8601 timestamp of when the tool call occurred

string | null

Name or identifier of the AI agent making the tool call

string | null

The name of the organization in your system that this usage belongs to.

string | null

The name of the product or application from your system for attribution

string | null

Subscriber or customer credential for billing attribution

string | null

Workflow identifier for multi-step process tracking

string | null
^(?!types$|conversion-funnel$)[a-zA-Z0-9][a-zA-Z0-9._-]{0,254}$

Unique identifier for the agentic job instance this tool call belongs to. Use the same value reported on the job's AI completion events so tool costs roll up to the job and its type in analytics.

string | null

Trace ID for distributed tracing correlation

usageMetadata
object | null

Additional usage metadata as key-value pairs

Headers
string
length between 1 and 255
^[!-~]+$

Optional key that makes retries safe. Revenium stores the response for each key in your account and replays it if you retry with the same key. Reusing a key with a different request body returns 409 idempotency_key_mismatch; retrying while the first request is still in progress returns 409 idempotency_key_in_progress with Retry-After: 1. Must be 1-255 printable ASCII characters; UUID v4 recommended. See https://docs.revenium.io/integrations/idempotency for full behavior.

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*