---
title: "Usage Endpoint"
method: POST
path: "/api/platform/usage"
tags: ["platform-sdk"]
---

# Usage Endpoint

`POST /api/platform/usage`

## Request

- Base URL: `https://api.tintin-x.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tintin-x.com/api/platform/usage`
- Auth: none declared

Fire-and-forget non-billing telemetry event. Logs a zero-amount
ledger row with `action_type='app_usage'` and the event details in
metadata. Aggregation surfaces in admin Usage tab.

## Request body

- UsageRequest: Non-billing telemetry event. Logs an `app_usage` ledger row with `amount=0` and the event details in metadata for later analytics.
  - `token` string, required
  - `event` string, required
  - `metadata` object, nullable

## Response `200`

Successful Response

- SrcSchemasPlatformSdkUsageResponse
  - `event_id` string, uuid, required

## Other responses

- `422`: Validation Error

---

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