---
title: "Record token usage"
method: POST
path: "/api/tokens"
tags: ["Tokens"]
---

# Record token usage

`POST /api/tokens`

## Request body

- object
  - `model` string, required
  - `sessionId` string, required
  - `inputTokens` integer, required
  - `outputTokens` integer, required
  - `operation` string
  - `duration` number

## Response `200`

Usage recorded

- object
  - `success` boolean
  - `record` TokenUsageRecord
    - `id` string
    - `model` string
    - `sessionId` string
    - `timestamp` integer
    - `inputTokens` integer
    - `outputTokens` integer
    - `totalTokens` integer
    - `cost` number
    - `operation` string
    - `duration` number

## Other responses

- `400` — Invalid request
- `401` — Authentication required
- `403` — Insufficient permissions

---

[API](https://skmtc.net/builderz-labs/apis/mission-control-api.md) · [All operations](https://skmtc.net/builderz-labs/apis/mission-control-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/builderz-labs/mission-control-api/revisions/b920835b2793/schema)