---
title: "Send New Message"
method: POST
path: "/api/v1/agents/test/messages"
tags: ["agents.test"]
---

# Send New Message

`POST /api/v1/agents/test/messages`

Send a new message

## Request body

- TestMessage — Message sent in a test chat with an agent.
  - `service_name` string, required — Name of the service producing the message
  - `source` string, required — Name of the source of the message - identifies the user, like an email or username.
  - `text` string, nullable — The text of the message
  - `test_id` string, required — Channel-manager-side ID of the session (see Session.channel_manager_sid)
  - `agent_id` string, required — ID of the agent with which the chat is taking place
  - `org_name` string, nullable — Unused: Name of the organization associated with the agent
  - `override_timestamp` string, nullable — Override for the timestamp of the message
  - `session_start` boolean — Whether this message is the start of a new session

## Response `200`

Successful Response

- TestMessageResponse — Response from an agent in a test chat.
  - `test_id` string, required — Channel-manager-side ID of the session (see Session.channel_manager_sid)
  - `agent_id` string, required — ID of the agent with which the chat is taking place
  - `text` string — The text of the message that elicited the response
  - `response` unknown, required
  - `response_text` string — The text of the response

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/asksyllable/apis/syllablesdk.md) · [All operations](https://skmtc.net/asksyllable/apis/syllablesdk/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/asksyllable/syllablesdk/revisions/534f1f22c775/schema)