---
title: "Record a bounded ChatGPT interaction"
method: POST
path: "/v2/analytics/chatgpt-events"
tags: ["Analytics"]
---

# Record a bounded ChatGPT interaction

`POST /v2/analytics/chatgpt-events`

## Request

- Base URL: `https://api.sync.so`
- URL: `https://api.sync.so/v2/analytics/chatgpt-events`
- Auth: API key in header `x-api-key`

Records allowlisted plugin telemetry under the authenticated Sync user. Does not start generation or change billing.

## Request body

- ChatgptEventDto
  - `event` 'chatgpt_ui_loaded' | 'chatgpt_project_opened' | 'chatgpt_asset_selected' | 'chatgpt_generate_clicked' | 'chatgpt_tool_called', required
  - `event_id` string, uuid, required
  - `attribution` object, required
    - `version` 1, required
    - `invocation_source` 'model' | 'ui' | 'background' | 'unknown', required
    - `journey_id` string, uuid
    - `action_id` string, uuid
    - `conversation_id` string
  - `tool_name` 'open-sync-app' | 'create-lipsync' | 'create-lipsync-from-assets' | 'create-translate-and-dub' | 'create-dialogue-video' | 'update-studio-draft' | 'open-studio-project' | 'save-studio-draft' | 'upload-media' | 'assets_create' | 'projects_create' | 'generate_estimate-cost' | 'create-timeline-lipsync' | 'create-dialogue-transcription' | 'create-dialogue-preview' | 'create-speech-preview' | 'create-translation-preview' | 'trim-audio' | 'voices_clone-voice'
  - `outcome` 'success' | 'error'
  - `duration_ms` number
  - `error_source` 'api' | 'mcp'
  - `error_status` integer
  - `error_code` string

## Response `204`

Telemetry accepted for best-effort collection.

## Changes

- **2026-11-05** `26662c96c138`: 15 info
  - added the new optional request property `error_code`
  - added the new optional request property `error_source`
  - added the new optional request property `error_status`
  - added the new `assets_create` enum value to the request property `tool_name`
  - …11 more
- **2026-10-29** `982b01c78920`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sync/apis/sync-api-v2/changes/v2/analytics/chatgpt-events/post.md)

---

[API](https://skmtc.dev/sync/apis/sync-api-v2.md) - [All operations](https://skmtc.dev/sync/apis/sync-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/sync/apis/sync-api-v2/revisions/26662c96c138?raw)