Payload for creating a run. Important: If the agent uses an input form trigger, the input field is required and must include all fields defined in the form schema. Even fields marked as optional in the UI must be included in the request—use an empty string ("") for optional fields without values. Omitting required form fields will result in a 500 error.
| Field | Type | Required | Description |
|---|---|---|---|
agent_id |
str | ✔️ | The ID of the agent to run. |
input |
Dict[str, Any] | ➖ | The input to the agent. Required when the agent uses an input form trigger. |
messages |
List[models.Message] | ➖ | The messages to pass an input to the agent. |
metadata |
Dict[str, Any] | ➖ | The metadata to pass to the agent. |
status |
Optional[models.AgentExecutionStatus] | ➖ | The status of the run. One of 'error', 'success'. |