Queue a run for a saved reusable agent.
This is a mutating tool. It requires socialcrm.write; OAuth users must have the admin or editor role.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
agentId |
string | Yes | ID returned by create_reusable_agent or list_reusable_agents |
brandId |
string | No | Company brand for this run; must be assigned if the agent has explicit assignments |
instructions |
string | No | Run-specific instructions, up to 4,000 characters |
The call returns immediately with a stable runId. Poll get_agent_run_status until the status is success, warning, error, or cancelled.
The runtime fails closed when its selected model provider is not configured; it does not persist placeholder model output as a successful result.