---
title: "Post Channel Query"
method: POST
path: "/api/v1/channel/query"
---

# Post Channel Query

`POST /api/v1/channel/query`

## Request

- Base URL: `http://127.0.0.1:8052`
- URL: `http://127.0.0.1:8052/api/v1/channel/query`
- Auth: none declared

Post a coordination query targeted at an agent or role.

## Request body

- ChannelQueryRequest: Body for POST /channel/query.
  - `sender_agent` string, required
  - `topic` string, required
  - `content` string, required
  - `target_agent` string, nullable
  - `target_role` string, nullable
  - `ttl_seconds` number

## Response `201`

Successful Response

- ChannelQueryResponse: Single channel query in API responses.
  - `id` string, required
  - `sender_agent` string, required
  - `topic` string, required
  - `content` string, required
  - `target_agent` string, nullable, required
  - `target_role` string, nullable, required
  - `timestamp` number, required
  - `expires_at` number, required
  - `resolved` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/bernstein/apis/bernstein-task-server.md) · [All operations](https://skmtc.dev/bernstein/apis/bernstein-task-server/llms.txt) · [OpenAPI document](https://skmtc.dev/bernstein/apis/bernstein-task-server/revisions/2a20a34ad2eb?raw)