---
title: "Send a chat message"
description: "Adds a user message and returns the assistant reply with citations. POST /api/v1/transcripts/{id}/chat/messages on the Verbafy REST API."
canonical: "https://verbafy.io/docs/api/chat/send-transcript-chat-message"
last-updated: "2026-10-04"
---

# 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).

## Parameters

| Name | Location | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `id` | path | Yes | string / uuid | Transcript UUID owned by the current account |

## 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."},
)
```

## 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 |

```json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Organization",
      "@id": "https://verbafy.io/#organization",
      "name": "Verbafy",
      "url": "https://verbafy.io",
      "logo": {
        "@type": "ImageObject",
        "url": "https://verbafy.io/opengraph-image.png"
      },
      "knowsAbout": [
        "YouTube transcription",
        "Spotify episode transcription",
        "Meeting recording transcription",
        "Speaker diarization",
        "Transcript export"
      ],
      "hasOfferCatalog": {
        "@type": "OfferCatalog",
        "@id": "https://verbafy.io/pricing#offers"
      },
      "contactPoint": {
        "@type": "ContactPoint",
        "contactType": "customer support",
        "email": "support@verbafy.io",
        "url": "https://verbafy.io/contact"
      }
    },
    {
      "@type": "WebSite",
      "@id": "https://verbafy.io/#website",
      "url": "https://verbafy.io",
      "name": "Verbafy",
      "inLanguage": "en",
      "publisher": {
        "@id": "https://verbafy.io/#organization"
      }
    },
    {
      "@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. POST /api/v1/transcripts/{id}/chat/messages on the Verbafy REST API.",
      "url": "https://verbafy.io/docs/api/chat/send-transcript-chat-message",
      "image": "https://verbafy.io/opengraph-image.png",
      "datePublished": "2026-09-09",
      "dateModified": "2026-10-04",
      "inLanguage": "en",
      "author": {
        "@type": "Organization",
        "@id": "https://verbafy.io/#organization",
        "name": "Verbafy"
      },
      "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"
        }
      ]
    }
  ]
}
```
