---
title: "Send a message and get a completion"
method: POST
path: "/public/v1/clones/{cloneId}/chats/{chatId}/completions"
tags: ["Chats"]
---

# Send a message and get a completion

`POST /public/v1/clones/{cloneId}/chats/{chatId}/completions`

## Request

- Base URL: `https://api.cloneforce.com`
- URL: `https://api.cloneforce.com/public/v1/clones/{cloneId}/chats/{chatId}/completions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/clone-global/apis/cloneforce-platform-api/docs/public/v1/clones/:cloneId/chats/:chatId/completions/post.ts> (a function with typed inputs; its response is checked against the schema)

Sends a user message to the clone and returns the assistant's response.

Set `stream: true` to receive the response as Server-Sent Events (SSE).
SSE events: `message.delta` (incremental text), `message.completed` (final message), `done` (stream end).

## Path parameters

- `cloneId` string, required
- `chatId` string, required

## Request body

- ChatCompletionRequest
  - `message` string, required: The user message to send to the clone
  - `stream` boolean: If true, response is streamed as SSE events

## Response `200`

Completion response (JSON when `stream` is false, SSE when `stream` is true)

- ChatCompletionResponse
  - `id` string, required
  - `chatId` string, required
  - `content` string, required
  - `role` string, required
  - `createdAt` string, date-time, required

## Other responses

- `401`: Missing or invalid API key
- `403`: API key lacks required scope
- `404`: Resource not found
- `409`: Chat is already being processed by another request

## Changes

- **2026-03-22** `0841f04b6bd8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/clone-global/apis/cloneforce-platform-api/changes/public/v1/clones/:cloneId/chats/:chatId/completions/post.md)

---

[API](https://skmtc.dev/clone-global/apis/cloneforce-platform-api.md) - [All operations](https://skmtc.dev/clone-global/apis/cloneforce-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clone-global/apis/cloneforce-platform-api/revisions/0841f04b6bd8?raw)