start_action_agent_session
Start a new Action Agent session and receive sessionId for send_action_agent_message.
start_action_agent_session
Start a new session with an ActionFlows agent. This tool does not stream. It returns the new session IDs.
Use list_action_agents or get_action_agent first. If you already have a sessionId, call send_action_agent_message.
See Installation for auth and response_format.
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
actionAgentId | string | Yes | Agent ID from list_action_agents. |
organizationId | string | No | Organization ID. Required unless the API key is organization-scoped. |
endUserId | string | No | Optional end-user identifier stored on the session. |
response_format | json or markdown | No | Default json. |
Each sessionId is one isolated chat. Do not reuse it across customers.
Example
{
"actionAgentId": "agent_123",
"organizationId": "org_123",
"endUserId": "user_abc"
}Returns
JSON with success and session (sessionId, externalId). Pass sessionId to send_action_agent_message.