---
title: "Run ledger across bots: record runs, one feed (runs + costs + failed API calls), daily rollup per bot."
method: POST
path: "/api/v1/ledger"
tags: ["ledger"]
---

# Run ledger across bots: record runs, one feed (runs + costs + failed API calls), daily rollup per bot.

`POST /api/v1/ledger`

## Request

- Base URL: `https://cloudforbots.com`
- URL: `https://cloudforbots.com/api/v1/ledger`
- Auth: HTTP bearer

## Request body

- object
  - `action` 'record' | 'feed' | 'rollup', required
  - `bot` string
  - `status` 'ok' | 'failed' | 'running' | 'skipped'
  - `run_id` string
  - `kind` string
  - `usd` number
  - `tokens_in` integer
  - `tokens_out` integer
  - `model` string
  - `ms` integer
  - `note` string
  - `since` string
  - `limit` integer
  - `days` integer

## Response `200`

ok

---

[API](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api.md) · [All operations](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api/revisions/1afdb5648693?raw)