---
title: "CreateThreadBody"
description: "Request body for creating a Thread."
section: "Reference"
group: "Types"
order: 231
---

## Definition

```ts
interface CreateThreadBody {
  workspaceId: string;
  title?: string | undefined;
  parentMessageId?: string | undefined;
}
```

## Fields

| Field             | Type                  | Notes                                                                                             |
| ----------------- | --------------------- | ------------------------------------------------------------------------------------------------- |
| `workspaceId`     | `string`              | `required` — Workspace that will own the thread.                                                  |
| `title`           | `string \| undefined` | `optional` — Optional initial title.                                                              |
| `parentMessageId` | `string \| undefined` | `optional` — Set when this thread is being created as a sub-thread rooted at an existing message. |