Suna Kortix icon

Suna Kortix

Interact with Suna Kortix AI Agents - Execute agents, manage sandboxes, and handle files

Tasks/Messages → Message Worker

AI-generated

Summary

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.

Links

Discussion