---
title: "POST /simulate/api/harness/attempts/{id}/usage/"
method: POST
path: "/simulate/api/harness/attempts/{id}/usage/"
tags: ["simulate"]
---

# POST /simulate/api/harness/attempts/{id}/usage/

`POST /simulate/api/harness/attempts/{id}/usage/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/simulate/api/harness/attempts/{id}/usage/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

## Request body

- HarnessUsageRequest
  - `operation` 'check' | 'report', required
  - `action` 'text_call' | 'voice_call'
  - `schema_version` 'futureagi.harness-usage.v1'
  - `records` HarnessUsageRecord[]
    - `id` string, uuid, required
    - `action` 'text_call' | 'voice_call', required
    - `scenario_key` string, required
    - `amount` number, required
    - `occurred_at` string, date-time, required
    - `funding` 'platform' | 'customer', required
    - `outcome` 'completed' | 'failed'
    - `failure_domain` 'agent' | 'simulator' | 'environment' | 'connectivity' | 'infrastructure' | 'grading' | 'artifact' | 'platform_sync', nullable

## Response `200`

OK

- HarnessUsageResponse
  - `allowed` boolean
  - `accepted` boolean
  - `reason` string
  - `error_code` string
  - `dimension` string
  - `current_usage` number
  - `limit` number
  - `upgrade_cta` object, nullable

## Other responses

- `402`: Payment Required
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)