Verbafy

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

NameLocationRequiredTypeDescription
idpathYesstring / uuidTranscript 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

StatusDescription
200User and assistant messages
400Validation or domain request error
401Missing or invalid Clerk Bearer token or guest session
402Plan or usage does not include this action
409Conflict with current resource state

Remote MCP at /api/v1/mcp is a companion wrap of this REST contract.