---
title: "Report monotonic bounded run usage"
method: POST
path: "/v1/automation-runs/{run_id}/usage"
tags: ["Automation"]
---

# Report monotonic bounded run usage

`POST /v1/automation-runs/{run_id}/usage`

## Request

- Base URL: `https://api.agentry.sh`
- URL: `https://api.agentry.sh/v1/automation-runs/{run_id}/usage`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Reports a monotonic sequence, turns, and optional cost; crossing the immutable budget escalates and closes the run.

## Path parameters

- `run_id` string, required

## Headers

- `X-Agentry-Lease-Token` string

## Request body

- object
  - `sequence` integer, required
  - `turns_used` integer, required
  - `cost_usd` number

## Response `200`

OK

- object
  - `run_id` string, required
  - `status` string, required
  - `sequence` integer, required
  - `turns_used` integer, required
  - `cost_usd` number, required
  - `idempotent_replay` boolean
  - `next_action` string, required

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/agentry/apis/agentry-api.md) · [All operations](https://skmtc.dev/agentry/apis/agentry-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentry/apis/agentry-api/revisions/abdecddf009f?raw)