---
title: "Chats"
description: "REST endpoints for chats. Bearer-auth required."
section: "API"
group: "REST"
order: 20
---

## POST /api/chats/kickoff

Kickoff a chat

Create a thread between an agent and a user, optionally seeded with an agent-authored opening message. Returns the new thread id.

**Request body**

```json
{
  "workspaceId": "string",
  "agentId": "string",
  "userId": "string",
  "message?": "string"
}
```

**Response**

```json
{
  "threadId": "string"
}
```