---
title: "Create Private Chat"
method: POST
path: "/worker/{worker_id}/private-chats"
tags: ["workers"]
---

# Create Private Chat

`POST /worker/{worker_id}/private-chats`

## Request

- Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.traversal.com/worker/{worker_id}/private-chats`
- Auth: none declared

Open a new private chat on this worker with its first message.

The path's ``worker_id`` is the parent; the response's ``worker_id`` is the chat.
Sends into the chat named by ``chat_id``, opening it if needed: a retry with the same
``message_id`` dedupes, while a new ``message_id`` is a second message in that chat.
Later messages go through ``POST /worker/{worker_id}/messages`` with the returned
``worker_id``.

## Path parameters

- `worker_id` string, required

## Request body

- CreatePrivateChatRequest: Opens a new private chat on a parent worker with its first message.
  - `chat_id` string, uuid, required
  - `message_id` string, uuid, required
  - `message` string, required

## Response `201`

Successful Response

- CreatePrivateChatResponse: The created chat, addressed by its own worker id from here on.
  - `worker_id` string, required
  - `message_id` string, required

## Other responses

- `422`: Validation Error

## Changes

> 66 revisions in range; 9 not diffed.

- **2026-10-02** `53b6ebae31bc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/traversal/apis/traversal-api/changes/worker/:worker_id/private-chats/post.md)

---

[API](https://skmtc.dev/traversal/apis/traversal-api.md) - [All operations](https://skmtc.dev/traversal/apis/traversal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traversal/apis/traversal-api/revisions/31e1a8b7cf89?raw)