---
title: "Record Metrics"
method: POST
path: "/v1/metrics/batch"
tags: ["agent-cost"]
---

# Record Metrics

`POST /v1/metrics/batch`

## Request body

- MetricsBatch
  - `events` MetricEvent[], required
    - `id` string, required
    - `occurred_at` string, date-time, required
    - `session_id` string
    - `install_id` string
    - `harness` string
    - `provider` string
    - `model` string
    - `action_kind` 'unknown' | 'log' | 'test_build_lint' | 'search' | 'file_list' | 'document_read' | 'agent_handoff' | 'query' | 'verbatim', required
    - `decision` string, required
    - `reason` string
    - `original_bytes` integer
    - `replacement_bytes` integer
    - `provider_input_tokens` integer
    - `provider_output_tokens` integer
    - `provider_cache_read_tokens` integer
    - `provider_cache_write_tokens` integer
    - `estimated_cost_microusd` integer
    - `reducer_cost_microusd` integer
    - `elapsed_ms` integer
    - `turn_count` integer
    - `retry_count` integer
    - `reread_count` integer
    - `retrieval_count` integer
    - `client_version` string

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/codag/apis/infra-logs-templater.md) · [All operations](https://skmtc.net/codag/apis/infra-logs-templater/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/codag/infra-logs-templater/revisions/44d8ea826f48/schema)