Send Message

Send a message to a conversation

POST /api/conversations/{conversation_id}/events

Try it

200

{
  "success": true
}

Path Parameters

conversation_id · string<uuid> · required

Body

application/json

Payload to send a message to the agent.

This is a simplified version of openhands.sdk.Message.

role · enum<string> · default: user

Available options: user, system, assistant, tool

content · (TextContent · object | ImageContent · object)[]

TextContent

ImageContent

Show child attributes

content. text · string · required

content. cache_prompt · boolean · default: false

content. type · string · default: text

Allowed value: "text"

run · boolean · default: false

Whether the agent loop should automatically run if not running

Response

200

application/json

Successful Response

success · boolean · default: true