---
title: "Records ludo CLI usage events (Roles: none, user)"
method: POST
path: "/cli/events"
tags: ["CLI"]
---

# Records ludo CLI usage events (Roles: none, user)

`POST /cli/events`

Anonymous-by-default usage telemetry from the ludo CLI: one event per command, keyed by a random install id, plus the account when the CLI sends its API key. Never carries flag values, prompts, paths or file contents. Stored in UserTracking as `cli:<command>`.

## Request body

- CliEventsPayload
  - `install_id` string, required
  - `events` CliEvent[], required
    - `command` string, required
    - `at` integer — When the command ran (unix seconds); defaults to now.
    - `props` object — Command facts (exit code, duration, flag names, versions, agent…); sanitized server-side.

## Response `200`

Success

- OkResponse
  - `ok` boolean

## Other responses

- `400` — Error

## Changes

- **2026-09-26** `2d6c17fc8fbf` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ludo/apis/ludo-ai-api/changes/cli/events/post.md)

---

[API](https://skmtc.dev/ludo/apis/ludo-ai-api.md) · [All operations](https://skmtc.dev/ludo/apis/ludo-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ludo/apis/ludo-ai-api/revisions/a6d8dcc39b12?raw)