Create Message

Create a new message in a chat

Authorization

Authorization<token>

Your v0 API key. Get one at https://v0.dev/chat/settings/keys

In: header

Path Parameters

chatIdstring

Path parameter "chatId"

Request Body

messagestring

attachments?array<object>

Default[]

modelConfiguration?object

Response Body

curl -X POST "https://api.v0.dev/v1/chats/string/messages" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "string"
  }'

{
  "id": "string",
  "object": "message",
  "chatId": "string",
  "url": "string",
  "files": [
    {
      "lang": "string",
      "meta": {
        "property1": "string",
        "property2": "string"
      },
      "source": "string"
    }
  ],
  "demo": "string",
  "text": "string",
  "modelConfiguration": {
    "modelId": "v0-1.5-sm",
    "imageGenerations": false,
    "thinking": false
  }
}

{
  "error": {
    "message": "string",
    "type": "unauthorized_error"
  }
}

{
  "error": {
    "message": "string",
    "type": "forbidden_error"
  }
}

{
  "error": {
    "message": "string",
    "type": "not_found_error"
  }
}

{
  "error": {
    "message": "string",
    "type": "conflict_error"
  }
}

{
  "error": {
    "message": "string",
    "type": "payload_too_large_error"
  }
}

{
  "error": {
    "message": "string",
    "type": "unprocessable_entity_error"
  }
}

{
  "error": {
    "message": "string",
    "type": "too_many_requests_error"
  }
}

{
  "error": {
    "message": "string",
    "type": "internal_server_error"
  }
}

Code Examples

cURL

Add Message to Chat

curl -X POST "https://api.v0.dev/v1/chats/chat_123abc/messages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Update the navbar to be more responsive"
  }'

TypeScript SDK

Using v0-sdk

import { v0 } from 'v0-sdk'

// Add message to existing chat
const response = await v0.chats.createMessage({
  chatId: 'chat_123abc',
  message: 'Update the navbar to be more responsive'
})
console.log('Message added:', response.id)