---
title: "Submit telemetry event"
method: POST
path: "/api/telemetry"
tags: ["Telemetry"]
---

# Submit telemetry event

`POST /api/telemetry`

## Request

- Base URL: `https://app.walkeros.io`
- URL: `https://app.walkeros.io/api/telemetry`
- Auth: none declared

Accept a single walkerOS v4 event from the CLI or MCP telemetry emitter. Public endpoint — no authentication. `source.type` is constrained to `cli` or `mcp`.

## Request body

- TelemetryEvent
  - `id` string, required
  - `name` string, required
  - `entity` string, required
  - `action` string, required
  - `data` object, required
  - `context` object, required
  - `globals` object, required
  - `custom` object, required
  - `user` object, required
    - `device` string, required
    - `session` string
    - `os` string, required
    - `osVersion` string, required
    - `node` string, required
    - `language` string, required
    - `timezone` string, required
  - `nested` unknown[], required
    - unknown
  - `consent` object, required
  - `trigger` string, required
  - `timestamp` number, required
  - `timing` number, required
  - `source` object, required
    - `type` 'cli' | 'mcp', required
    - `platform` string
    - `release` object
    - `version` string
    - `schema` string
    - `tool` string
    - `command` string

## Response `204`

Telemetry event accepted

## Other responses

- `400`: Validation error

---

[API](https://skmtc.dev/walkeros/apis/walkeros-tag-manager-api.md) · [All operations](https://skmtc.dev/walkeros/apis/walkeros-tag-manager-api/llms.txt) · [OpenAPI document](https://skmtc.dev/walkeros/apis/walkeros-tag-manager-api/revisions/1b692e17a011?raw)