Skip to main content
POST
Steer a live task with mid-run user input

Authorizations

Authorization
string
header
required

JWT authentication token

Path Parameters

id
string<uuid>
required

Task ID

Body

application/json
text
string
required

Composer text to inject into the live run

Required string length: 1 - 32000
id
string<uuid>

Idempotency key and mastra_messages id. Reuse the same id on retries so a duplicate POST cannot mint a new signal. Go mints one when omitted.

mode
enum<string>
default:steer

v1 only supports steer (inject at the next LLM step)

Available options:
steer
stream_id
string<uuid>

Live SSE stream this composer send was typed against. When set, the API returns 409 if that stream is no longer live — including when a newer run on the same chat has started. Prevents a retried steer (e.g. "stop") from attaching to the next turn. Send the stream_id from the live SSE metadata.

subagent_run_id
string

Optional target for one live subagent invocation. This is the subagent stream srid, which is also the parent trigger toolCallId. When omitted, the steer is broadcast to the parent and all subagents on the live stream.

Required string length: 1 - 512

Response

Input accepted and forwarded to the live stream

id
string
required
message
string
required
stream_id
string
required
success
boolean
required
applied_locally
boolean