For the complete documentation index, see llms.txt. For the full corpus, see llms-full.txt. For raw markdown, append .md to this URL or send Accept: text/markdown.

Submit

Submit feedback via the API

Last updated: May 19, 2026

This endpoint is what the Feedback SDK calls under the hood. You can call it directly if you’re not using the SDK.

Submit Feedback

POST /v1/feedback/submit Secret key

Submit a feedback entry for a given feedback type.

Parameter	Type	Required	Description
feedbackTypeId (body)	string	✓	The feedback type slug (created in the dashboard)
propertyId (body)	string	✓	Property the feedback type belongs to
sessionId (body)	string	✓	Session the feedback belongs to (max 500 chars). Visitor and user identity are resolved from the session on the backend.
option (body)	string		Selected option value (must match a pre-defined option)
message (body)	string		Free-text message (max 5000 characters, only if feedback type allows text)
metadata (body)	object		Key-value string pairs for additional context

Response

{ "success": true }

Example

bash

curl -X POST "https://api.sessionsight.com/v1/feedback/submit" \
  -H "x-api-key: YOUR_SECRET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "feedbackTypeId": "",
  "propertyId": "",
  "sessionId": "",
  "option": "",
  "message": "",
  "metadata": ""
}'

Notes

The feedbackTypeId must match a feedback type slug that exists in your dashboard for the given property
If option is provided, it must match one of the pre-defined option values for the feedback type
message is only accepted if the feedback type has text input enabled
metadata values must be strings