Send a chat message
Adds a user message and returns the assistant reply with citations.
POST /api/v1/transcripts/{id}/chat/messages
OpenAPI operation sendTranscriptChatMessage. 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 |
Request example
curl -X POST 'https://verbafy.io/api/v1/transcripts/{id}/chat/messages' \
-H 'Authorization: Bearer {jwt}' \
-H 'Content-Type: application/json' \
-d '{"content":"Summarize the main claims."}'Responses
| Status | Description |
|---|---|
200 | User and assistant messages |
400 | Validation or domain request error |
401 | Missing or invalid Clerk Bearer token or guest session |
402 | Plan or usage does not include this action |
409 | Conflict with current resource state |
Remote MCP at /api/v1/mcp is a companion wrap of this REST contract.
Rate a chat message
Sets or clears an up/down rating on one assistant message. PUT /api/v1/transcripts/{id}/chat/messages/{messageId}/rating on the Verbafy REST API.
Remote MCP Streamable HTTP DELETE
Same Streamable HTTP endpoint as POST. API Key Bearer required. DELETE /api/v1/mcp on the Verbafy REST API. See the Verbafy OpenAPI contract for request and