Submit feedback on a message | Runtype Documentation

Record message-level (upvote / downvote / copy, requires messageId) or conversation-level (csat 1-5, nps 0-10, requires rating) feedback for a client-token session. Requires the client token (authenticated like /init and /chat): the token is verified, its origin allowlist is enforced, and the session lookup is scoped to the token. Idempotent per (session, type, message): a matching prior submission is updated. Expired-but-active sessions are accepted so post-conversation surveys still land.

Record message-level (`upvote` / `downvote` / `copy`, requires `messageId`) or conversation-level (`csat` 1-5, `nps` 0-10, requires `rating`) feedback for a client-token session. Requires the client `token` (authenticated like `/init` and `/chat`): the token is verified, its origin allowlist is enforced, and the session lookup is scoped to the token. Idempotent per (session, type, message): a matching prior submission is updated. Expired-but-active sessions are accepted so post-conversation surveys still land.

Request

This endpoint expects an object.

sessionIdstringRequired>=1 character

tokenstringRequired>=1 character

typeenumRequired

Allowed values:

commentstringOptional

messageIdstringOptional

metadatamap from strings to anyOptional

ratingdoubleOptional

Response

Existing feedback updated

feedbackIdstring

successboolean

messagestring

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X POST https://api.runtype.com/v1/client/feedback \
>	-H "Content-Type: application/json" \
>	-d '{
>	"sessionId": "clsess_01jq8z6k2re9v0w1m3n5p7s9t2",
>	"token": "string",
>	"type": "csat",
>	"comment": "Super helpful, thanks!",
>	"rating": 5
>	}'