Skip to main content
Endpoint · POST /conversation/actions
Runs an AI employee. ai_employee is optional — without it, it uses the one assigned to the conversation. instructions is optional. Fields
  • ai_employee — { name } of the AI employee (optional; without it, uses the one assigned to the conversation).
  • instructions — free text (optional).
In a list, this object goes in the actions array of a POST /conversation/actions — see Assembling an action list.

​
Executable example

A run_ai on a conversation identified by phone and channel. With ai_employee it runs an explicit employee; without it, it runs the AI employee assigned to the conversation. instructions is optional.

​
Request

​
Response

202 Accepted — the group was accepted and runs in the background. The per-action result does not travel in the response (query it later — see How it runs).
​
string
Always processing: confirms the group was accepted and is running.
​
integer
How many actions in the array were admitted for execution — not how many succeeded.