---
title: "Broadcast Command"
method: POST
path: "/broadcast"
---

# Broadcast Command

`POST /broadcast`

Send a message to all running agents via fastest available channel.

Uses stdin pipe where available (sub-second delivery), falls back
to file-based COMMAND signal for agents without pipe support.

Expects JSON body: ``{"message": "some instruction"}``.

## Request body

- BroadcastRequest — Body for ``POST /broadcast``. Typing the body with a model lets FastAPI reject non-object or malformed JSON with a ``422`` instead of letting ``dict.get`` (or a ``JSONDecodeError``) raise an unhandled exception. ``message`` defaults to an empty string so a missing field still funnels into the existing ``400 message is required`` path.
  - `message` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

> 15 revisions in range; 7 could not be searched.

- **2026-07-26** `2a1299ef19fa` — 1 breaking, 1 info
  - added required request body
  - added the non-success response with the status `422`

[Change history](https://skmtc.dev/sipyourdrink-ltd/apis/bernstein-task-server/changes/broadcast/post.md)

---

[API](https://skmtc.dev/sipyourdrink-ltd/apis/bernstein-task-server.md) · [All operations](https://skmtc.dev/sipyourdrink-ltd/apis/bernstein-task-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sipyourdrink-ltd/bernstein-task-server/revisions/7f4871ff054a/schema)