Rate a chat message
Sets or clears an up/down rating on one assistant message.
PUT /api/v1/transcripts/{id}/chat/messages/{messageId}/rating
OpenAPI operation rateTranscriptChatMessage. Authenticate with a Clerk session JWT (Authorization: Bearer {jwt}) or the verbafy_guest_session cookie. {jwt} is a Clerk session token after you sign in on the website. Verbafy does not issue that token and does not show it in Settings. For scripts and agents, sign in, create an API key at Settings → API keys, and call Remote MCP with Authorization: Bearer sk-…. Credential setup: Auth.md. Machine-readable contract: OpenAPI.
Parameters
| Name | Location | Required | Type | Description |
|---|---|---|---|---|
id | path | Yes | string / uuid | Transcript UUID owned by the current account |
messageId | path | Yes | string / uuid | Chat message UUID |
Request example
curl -X PUT 'https://verbafy.io/api/v1/transcripts/{id}/chat/messages/{messageId}/rating' \
-H 'Authorization: Bearer {jwt}' \
-H 'Content-Type: application/json' \
-d '{"rating":"up"}'Responses
| Status | Description |
|---|---|
200 | Updated message |
400 | Validation or domain request error |
401 | Missing or invalid Clerk Bearer token or guest session |
404 | Resource not found for the current account |
Remote MCP at /api/v1/mcp is a companion wrap of this REST contract.
Get transcript chat
Returns the chat session, readiness, and messages for one owned transcript. GET /api/v1/transcripts/{id}/chat on the Verbafy REST API.
Send a chat message
Adds a user message and returns the assistant reply with citations. POST /api/v1/transcripts/{id}/chat/messages on the Verbafy REST API.