---
title: "Send a message to an existing chat conversation"
method: POST
path: "/{version}/{account_id}/{project_id}/chat/respond"
---

# Send a message to an existing chat conversation

`POST /{version}/{account_id}/{project_id}/chat/respond`

Sends a user message to an existing conversation and returns the agent's response.

## Path parameters

- `version` string, required
- `account_id` string, required
- `project_id` string, required

## Headers

- `X-API-KEY` string, required
- `X-TOKEN` string, required

## Request body

- RespondChatRequest
  - `conversation_id` string, required — ID of the conversation to respond to
  - `message` string — Message to send to the agent

## Response `200`

OK

- RespondChatResponse
  - `conversation_id` string, required — ID of the conversation
  - `response` string, required — Response message from the agent
  - `end_conversation` boolean, required — Whether the conversation should be ended
  - `handoff` object — Information about handoff if applicable
    - `destination` string — Destination for the handoff
    - `reason` string — Reason for the handoff

## Other responses

- `400` — Validation error.
- `401` — Missing or invalid API key.
- `403` — Missing or invalid API key.
- `404` — Resource not found.
- `500` — Internal Server Error.

---

[API](https://skmtc.net/poly/apis/polyai-agents-api.md) · [All operations](https://skmtc.net/poly/apis/polyai-agents-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poly/polyai-agents-api/versions/76f3c606e395/schema)