---
title: "Send Message"
method: POST
path: "/worker/{worker_id}/messages"
tags: ["workers"]
---

# Send Message

`POST /worker/{worker_id}/messages`

## 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}/messages`
- Auth: none declared

## Path parameters

- `worker_id` string, required

## Request body

- SendWorkerMessageRequest: One authenticated user message bound for a deployed worker. Worker-scoped, not web-specific: the target is a worker (addressed by its id in the route path), and today that worker is web-native. The web UI is the transport; the domain is "a message to a worker," so a future non-web target needs no new schema.
  - `message_id` string, uuid, required
  - `message` string, required
  - `thread_id` string, nullable

## Response `201`

Successful Response

- SendWorkerMessageResponse: Acknowledges a recorded inbound worker message.
  - `message_id` string, required

## Other responses

- `422`: Validation Error

---

[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)