---
title: "Record Embed Event"
method: POST
path: "/api/agents/{agent_identity_id}/embed/events"
tags: ["agent-embed"]
---

# Record Embed Event

`POST /api/agents/{agent_identity_id}/embed/events`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/agents/{agent_identity_id}/embed/events`
- Auth: none declared

Record bounded owner UI adoption signals, not proof of visitor activity.

Closed fields exclude page URLs, identifiers, visitor credentials and
transcripts. The route never writes conversation data or calls a model.

## Path parameters

- `agent_identity_id` string, uuid, required

## Headers

- `x-impersonate-identity-id` string, nullable

## Request body

- EmbedEventBody
  - `event_key` 'setup_failed' | 'setup_opened' | 'platform_selected' | 'settings_saved' | 'snippet_copied' | 'installation_detected' | 'session_ready' | 'answer_complete', required
  - `platform` 'custom' | 'react' | 'ai' | 'wix' | 'webflow' | 'framer' | 'wordpress' | 'squarespace' | 'shopify' | 'html'
  - `mode` 'floating' | 'inline' | 'iframe' | 'button' | 'react' | 'ai'
  - `failure_category` 'configuration' | 'origin' | 'csp' | 'storage' | 'limits' | 'network' | 'provider' | 'unknown'

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

---

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