---
title: "Ingest a batch of anonymous first-party telemetry events."
method: POST
path: "/events"
tags: ["Telemetry"]
---

# Ingest a batch of anonymous first-party telemetry events.

`POST /events`

## Request

- Base URL: `https://www.livediagram.app/api`
- URL: `https://www.livediagram.app/api/events`
- Auth: none required

## Request body

- object
  - `events` TelemetryEvent[]
    - `action` 'Created' | 'Deleted' | 'Added' | 'Removed' | 'Shared' | 'Joined' | 'Declined' | 'Used' | 'Changed' | 'Exported' | 'Locked' | 'Unlocked' | 'Grouped' | 'Ungrouped' | 'Duplicated' | 'Renamed' | 'Reordered' | 'Linked' | 'Unlinked' | 'Resolved' | 'Unresolved' | 'Mentioned' | 'Imported' | 'Aligned' | 'Undone' | 'Redone' | 'Cleared' | 'Loaded' | 'Opened' | 'Searched' | 'Selected' | 'Toggled' | 'Zoomed' | 'Moved' | 'Closed' | 'Copied' | 'Reverted' | 'SignedIn' | 'SignedUp' | 'SignedOut' | 'Started' | 'Ended' | 'Revealed' | 'Voted' | 'View' | 'Helpful' | 'Unhelpful' | 'Returned' | 'Restored' | 'Applied' | 'Conflicted' | 'Present' | 'Held' | 'Viewed' | 'Sent' | 'Api' | 'Client' | 'Warning' | 'Liked' | 'Unliked' | 'Reported' | 'Measured', required
    - `category` 'Document' | 'Element' | 'Tab' | 'Theme' | 'Canvas' | 'Template' | 'Comment' | 'Note' | 'Action' | 'Search' | 'UI' | 'Folder' | 'Layer' | 'Session' | 'Facilitator' | 'AI' | 'Team' | 'Participant' | 'Help' | 'Token' | 'Mcp' | 'Cli' | 'Email' | 'Error' | 'Timeline' | 'Home' | 'Activity' | 'Page' | 'Cta' | 'Trash' | 'Draw' | 'Editor' | 'Drive' | 'Explorer' | 'Agent' | 'Plan' | 'Sheet' | 'Form' | 'Community' | 'Timing', required
    - `type` string, nullable

## Response `204`

Success.

---

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