---
title: "Send Chat Message"
method: POST
path: "/chats/{chat_id}/messages"
tags: ["Chats"]
---

# Send Chat Message

`POST /chats/{chat_id}/messages`

## Request

- Base URL: `https://zeronoise.ai/api/v1`
- URL: `https://zeronoise.ai/api/v1/chats/{chat_id}/messages`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string, required

## Request body

- ChatMessageInput
  - `text` string, required
  - `intent` 'edit_agent' | 'discover_sources', nullable
  - `references` ResourceReference[]
    - `object` string, required
    - `id` string, required: Opaque identifier; clients must not parse its format.

## Response `202`

Asynchronous work admitted

- OperationAccepted
  - `operation` Operation, required
    - `id` string, required: Opaque identifier; clients must not parse its format.
    - `object` 'operation', required
    - `capability` string, required
    - `status` string, required
    - `subject` ResourceReference, nullable, required
      - `object` string, required
      - `id` string, required: Opaque identifier; clients must not parse its format.
    - `caused_by` ResourceReference, nullable
      - `object` string, required
      - `id` string, required: Opaque identifier; clients must not parse its format.
    - `progress` object, nullable
    - `result` union: Present when durable results exist. The capability determines the result family; fields may be absent on historical Operations.
      - AuthoringOperationResult, nullable
        - `agent` ResourceReference, nullable
          - `object` string, required
          - `id` string, required: Opaque identifier; clients must not parse its format.
        - `chat` ResourceReference, nullable
          - `object` string, required
          - `id` string, required: Opaque identifier; clients must not parse its format.
        - `message` ResourceReference, nullable
          - `object` string, required
          - `id` string, required: Opaque identifier; clients must not parse its format.
        - `references` ResourceReference[]
          - `object` string, required
          - `id` string, required: Opaque identifier; clients must not parse its format.
        - `proposal` ResourceReference, nullable
          - `object` string, required
          - `id` string, required: Opaque identifier; clients must not parse its format.
        - `action_request` ResourceReference, nullable
          - `object` string, required
          - `id` string, required: Opaque identifier; clients must not parse its format.
        - `configuration_etag` string
        - `before_configuration_etag` string, nullable
        - `applied_effects` string[]
      - DiscoveryOperationResult
        - `outcome` string
        - `counts` object
          - `checked` integer
          - `ready` integer
          - `suggestions_ready` integer
        - `gaps` string[]
        - `stop_reason` string
        - `sources` object
          - `object` 'source_collection', required
          - `agent_id` string, required: Opaque identifier; clients must not parse its format.
          - `created_by_operation_id` string, required: Opaque identifier; clients must not parse its format.
          - `href` string, required
        - `created_pending` integer: Legacy result count.
        - `matched_existing` integer: Legacy result count.
        - `skipped` integer: Legacy result count.
        - `failed` integer: Legacy result count.
      - BriefOperationResult
        - `brief` ResourceReference, nullable
          - `object` string, required
          - `id` string, required: Opaque identifier; clients must not parse its format.
        - `href` string
      - SourceIngestionOperationResult
        - `total` integer
        - `processed` integer
        - `added` integer
        - `added_channels` integer
        - `added_web_sources` integer
        - `duplicate` integer
        - `invalid` integer
        - `errors` integer
    - `error` OperationError, nullable
      - `code` string, required
      - `message` string, required
    - `usage` OperationUsage, nullable
      - `amount_usd` string
      - `charged` boolean
    - `created_at` string, date-time, required
    - `started_at` string, date-time
    - `completed_at` string, date-time
    - `updated_at` string, date-time, required
    - `links` Links, required

## Other responses

- `default`: RFC 9457 problem response

---

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