---
title: "Send Http Text Message"
method: POST
path: "/v1/send-http-text-message"
tags: ["HTTP Text Agent"]
---

# Send Http Text Message

`POST /v1/send-http-text-message`

Receive a text message via HTTP, process it through the lambda, and send response to webhook.
Uses simulation_result_id (sim_conversation_id) for Redis operations and evaluations.

## Headers

- `X-API-Key` string, required

## Request body

- union — Request wrapper that defaults missing ``type`` to ``message``.
  - HttpTextAgentUserMessageRequest — Chat message: Send a message to the user.
    - `simulation_result_id` string, required — ID of the simulation result (test result)
    - `end_conversation` boolean, nullable — If true, skip lambda and end/evaluate the conversation
    - `end_turn` boolean, nullable — If true, process the message now; if false, stack it for later
    - `message_id` string, nullable — Unique message ID for deduping within a conversation
    - `type` 'message' — Send a message to the user
    - `message` string, required — Text message to send
  - HttpTextAgentToolCallRequest — Tool invocation: Logs a tool call
    - `simulation_result_id` string, required — ID of the simulation result (test result)
    - `end_conversation` boolean, nullable — If true, skip lambda and end/evaluate the conversation
    - `end_turn` boolean, nullable — If true, process the message now; if false, stack it for later
    - `message_id` string, nullable — Unique message ID for deduping within a conversation
    - `type` 'tool_call', required — Log a tool call
    - `name` string, required — Tool name
    - `parameters` object, nullable — Tool parameters
    - `output` unknown

## Response `200`

Successful Response

- HttpTextMessageResponse — Response model for HTTP text message
  - `simulation_result_id` string, required — Simulation result ID
  - `status` string — Status of the response
  - `end_conversation` boolean — Whether the conversation has ended

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/getbluejay/apis/bluejay-api.md) · [All operations](https://skmtc.net/getbluejay/apis/bluejay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbluejay/bluejay-api/revisions/18bc44e35414/schema)