Metering

Emit Metering Event

post

Emit one metering event for the calling workspace.

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

workspace_idstring · uuidRequired

Body

application/json

event_typestring · min: 1 · max: 64RequiredPattern: ^[a-z][a-z0-9._]*$

metering_quantitynumberRequired

metering_sourcestring · enumRequired

Traffic class — 'production' or 'simulation'.

Possible values:

effective_atany ofOptional

When the event happened. Defaults to ingest time.

string · date-timeOptional

or

nullOptional

metering_unitany ofOptional

string · min: 1 · max: 32Optional

or

nullOptional

metering_metadataany ofOptional

or

nullOptional

Responses

202

Successful Response

application/json

statusconst: acceptedRequired

Emission outcome. Always 'accepted' on 202.

event_typestring · min: 1 · max: 64Required

Echo of the emitted event_type.

422

Validation Error

application/json

post

/v1/{workspace_id}/metering/emit

HTTPcURLJavaScriptPython

POST /v1/{workspace_id}/metering/emit HTTP/1.1
Host: api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 198

{
  "event_type": "text",
  "metering_quantity": 1,
  "metering_source": "production",
  "effective_at": "2026-05-12T12:14:53.871Z",
  "metering_unit": "text",
  "metering_metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "status": "text",
  "event_type": "text"
}