Actions28
- Agent Actions
- Project Actions
- Sandbox Actions
- Tasks/Messages Actions
- Thread Actions
Tasks/Messages → Message Worker
AI-generatedSummary
Send a message to a selected Suna Kortix worker, optionally continuing a thread, overriding the model, and attaching input binary files. The operation starts an agent run and returns the API response for that run.
Inputs
- Worker (required) — Select a worker from the list, enter its ID, or provide its worker configuration URL.
- Message — Text prompt sent to the worker; defaults to an empty string.
- Specify Thread ID — Enable this to continue a conversation in an existing thread.
- Thread ID — Shown when Specify Thread ID is enabled. Select a thread, enter its ID, or provide a thread URL.
- Specify Model Name — Enable this to override the worker's default model.
- Model Name (Deprecated) — Shown when Specify Model Name is enabled. Choose a model from the list or enter its model ID.
- Include All Attachments — When enabled, uploads every binary property on the current input item. Defaults to false.
- Include Specific File Attachment — When enabled, uploads the binary property named below. Defaults to false; this is used only when Include All Attachments is off.
- File Attachment Binary Property — Binary property name to upload when Include Specific File Attachment is enabled; defaults to
data.
Output shape
A single API response object for the started worker run.
The response fields depend on the Suna Kortix API. The operation runs once per input item; when attaching all binaries, properties that cannot be read are skipped, while a missing specifically selected binary property raises an error.