Send a user message to an Action Agent session and wait for the completed assistant reply. Non-streaming.

send_action_agent_message

Send a user message to an agent session and wait for the completed assistant reply.

This tool is non-streaming and can take a while. For live tokens, use the REST SSE endpoint or the TypeScript SDK.

send_action_agent_message never creates a session. Call start_action_agent_session first. A wrong sessionId fails.

See Installation for auth and response_format.

Arguments

Argument	Type	Required	Description
`actionAgentId`	string	Yes	Agent ID.
`sessionId`	string	Yes	Session ID from `start_action_agent_session`.
`message`	string	Yes	User message text. Non-empty, max 100,000 characters.
`organizationId`	string	No	Organization ID for access checks.
`response_format`	`json` or `markdown`	No	Default `json`.

{
  "actionAgentId": "agent_123",
  "sessionId": "session_456",
  "organizationId": "org_123",
  "message": "Where is my invoice?"
}

JSON with success and result (assistant text and message metadata).

Not found: confirm actionAgentId and sessionId. Invalid arguments: message must be non-empty and within the length limit.