Suna Kortix icon

Suna Kortix

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

Tasks/Messages → Message Worker (Optimistic)

AI-generated

Summary

Send an initial message to a Suna Kortix worker using the optimistic, non-blocking start endpoint. You can start a new thread or continue an existing one, optionally choose a model, and attach binary input files.

Inputs

  • Worker (required) — Select a worker from the list, enter its ID, or provide its configuration URL.
  • Message — Initial prompt sent to the worker; an empty value is omitted from the request.
  • Specify Thread ID — Enable this to continue an existing thread.
  • Thread ID — Existing thread to continue, selected from the list or entered by ID or URL; used only when Specify Thread ID is enabled.
  • Specify Model Name — Enable this to override the worker's default model.
  • Model Name (Deprecated) — Model ID to use, selected from the available list or entered directly; used only when Specify Model Name is enabled.
  • Include All Attachments — When enabled, includes all binary properties on the input item as file attachments.
  • Include Specific File Attachment — When enabled and Include All Attachments is off, uploads the binary property named below.
  • File Attachment Binary Property — Name of the input binary property to upload when Include Specific File Attachment is enabled; defaults to data.

Output shape

A single API response record per input item.

Calls the optimistic agent-start endpoint and returns its response, which may acknowledge the run before it completes. When Include All Attachments is enabled, binary properties that cannot be read are skipped; a missing specifically selected binary property causes an error. If both attachment options are enabled, Include All Attachments takes precedence.

Links

Discussion