Skip to main content
PUT
/
api
/
analytics
/
events
Send User Event Data
curl --request PUT \
  --url https://api.trieve.ai/api/analytics/events \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'TR-Dataset: <tr-dataset>' \
  --data '
{
  "event_name": "<string>",
  "items": [
    "<string>"
  ],
  "location": "<string>",
  "metadata": "<unknown>",
  "user_id": "<string>"
}
'
{
  "message": "Bad Request"
}

Documentation Index

Fetch the complete documentation index at: https://docs.trieve.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Headers

​
TR-Dataset
string<uuid>
required

The dataset id or tracking_id to use for the request. We assume you intend to use an id if the value is a valid uuid.

Body

application/json

JSON request payload to send event data

​
event_name
string
required

The name of the event

​
event_type
enum<string>
required
Available options:
view
​
items
string[]
required

The items that were viewed

​
location
string | null

The location of the event

​
metadata
any | null

Any other metadata associated with the event

​
request
object
​
user_id
string | null

The user id of the user who viewed the items

Response

The event data was successfully sent