Sign in
Usage

Ingest usage event

Changed on
post/v1/usage-events

Request

  • Base URL: http://localhost:8080
  • URL: http://localhost:8080/v1/usage-events
  • Auth: HTTP bearer

Request body

external_customer_idstring required

The customer's external_id (your identifier), not the internal vlx_cus_ id.

event_namestring required

The meter key (e.g. "tokens").

dimensionsobject

Scalar dimension values used for pricing-rule dispatch (e.g. {"model", "token_type"}).

propertiesobject
idempotency_keystring
timestampstring date-time

Response

Idempotency replay — the original event is returned unchanged with an Idempotent-Replayed: true header. No duplicate row is written.

Changes

  • 11e1609b0b1bRevision changes
    • info

      added the success response with the status

  • b0f99b9e82cfRevision changes
    • breaking

      added the new required request property

    • breaking

      added the new required request property

    • breaking

      request property list-of-types was narrowed by removing types integer from media type application/json

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • info

      added the new optional request property