---
title: "POST /threads"
method: POST
path: "/threads"
tags: ["threads"]
---

# POST /threads

`POST /threads`

## Request body

- ThreadRequest
  - `contextKey` string — Unique user identifier for the thread
  - `metadata` object
  - `projectId` string, required
  - `generationStage` 'IDLE' | 'CHOOSING_COMPONENT' | 'FETCHING_CONTEXT' | 'HYDRATING_COMPONENT' | 'STREAMING_RESPONSE' | 'COMPLETE' | 'ERROR' | 'CANCELLED'
  - `statusMessage` string
  - `name` string

## Response `201`

- Thread
  - `metadata` object
  - `projectId` string, required
  - `generationStage` 'IDLE' | 'CHOOSING_COMPONENT' | 'FETCHING_CONTEXT' | 'HYDRATING_COMPONENT' | 'STREAMING_RESPONSE' | 'COMPLETE' | 'ERROR' | 'CANCELLED'
  - `statusMessage` string
  - `name` string
  - `id` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

---

[API](https://skmtc.net/tambo-ai/apis/tambo-api.md) · [All operations](https://skmtc.net/tambo-ai/apis/tambo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tambo-ai/tambo-api/revisions/312691b28f1c/schema)