---
title: "Send a chat message"
description: "Adds a user message and returns the assistant reply with citations."
canonical: "https://verbafy.io/docs/api/chat/send-transcript-chat-message"
last-updated: "2026-09-23"
---

# 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](/app/settings/api-keys), and call Remote MCP with `Authorization: Bearer sk-…`. Credential setup: [Auth.md](/auth.md). Machine-readable contract: [OpenAPI](/openapi.json).

## curl

```curl
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."}'
```

## JavaScript

```javascript
const response = await fetch('https://verbafy.io/api/v1/transcripts/{id}/chat/messages', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer {jwt}',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"content":"Summarize the main claims."})
});
```

## Python

```python
import httpx

response = httpx.post(
    "https://verbafy.io/api/v1/transcripts/{id}/chat/messages",
    headers={"Authorization":"Bearer {jwt}","Content-Type":"application/json"},
    json={"content":"Summarize the main claims."},
)
```

```json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Organization",
      "@id": "https://verbafy.io/#organization",
      "name": "Verbafy",
      "url": "https://verbafy.io",
      "inLanguage": "en",
      "knowsAbout": [
        "YouTube transcription",
        "Spotify episode transcription",
        "Meeting recording transcription",
        "Speaker diarization",
        "Transcript export"
      ],
      "hasOfferCatalog": {
        "@id": "https://verbafy.io/pricing#offers"
      },
      "contactPoint": {
        "@type": "ContactPoint",
        "contactType": "customer support",
        "email": "support@verbafy.io",
        "url": "https://verbafy.io/contact"
      }
    },
    {
      "@type": "TechArticle",
      "@id": "https://verbafy.io/docs/api/chat/send-transcript-chat-message#page",
      "name": "Send a chat message",
      "description": "Adds a user message and returns the assistant reply with citations.",
      "url": "https://verbafy.io/docs/api/chat/send-transcript-chat-message",
      "inLanguage": "en",
      "isPartOf": {
        "@id": "https://verbafy.io/#website"
      },
      "publisher": {
        "@id": "https://verbafy.io/#organization"
      }
    },
    {
      "@type": "BreadcrumbList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "name": "Home",
          "item": "https://verbafy.io"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "name": "Send a chat message",
          "item": "https://verbafy.io/docs/api/chat/send-transcript-chat-message"
        }
      ]
    }
  ]
}
```