---
title: "Session Billing Usage"
method: POST
path: "/api/v1/nova/sessions/{session_id}/billing-usage"
tags: ["nova"]
---

# Session Billing Usage

`POST /api/v1/nova/sessions/{session_id}/billing-usage`

## Path parameters

- `session_id` string, uuid, required

## Headers

- `authorization` string, nullable

## Request body

- UsageBatch
  - `events` UsageEvent[], required
    - `event_id` string, required
    - `org_id` string, uuid, nullable
    - `agent_id` string, uuid, nullable
    - `feature` 'protected_request' | 'guardrail_ai' | 'nova_ai' | 'discovery_ai', required
    - `timestamp` string, date-time, required
    - `quantity` integer
    - `provider` string, nullable
    - `model` string, nullable
    - `input_tokens` integer
    - `output_tokens` integer
    - `input_cached_tokens` integer
    - `input_cache_creation_tokens` integer
    - `output_reasoning_tokens` integer
    - `provider_cost_usd` string, nullable
    - `cancelled` boolean
    - `actor_kind` 'user' | 'system' | 'end_user', nullable
    - `actor_id` string, nullable
    - `component` 'scanner' | 'security_reviewer', nullable
    - `payer` 'xenovia' | 'customer'

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-27** `b20a3bdd6219` — 1 warning, 1 info
  - removed the request property `events/items/proxy_id`
  - added the new optional request property `events/items/agent_id`
- **2026-09-19** `729390e1c2f0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/xenovia/apis/controlplane/changes/api/v1/nova/sessions/:session_id/billing-usage/post.md)

---

[API](https://skmtc.dev/xenovia/apis/controlplane.md) · [All operations](https://skmtc.dev/xenovia/apis/controlplane/llms.txt) · [OpenAPI document](https://skmtc.dev/xenovia/apis/controlplane/revisions/b20a3bdd6219?raw)