SHshortcut
Spreadsheets

Steer Spreadsheet Job

Changed on

Send an instruction to a running spreadsheet job. The agent reads it at its next model turn, after the tool calls it is waiting on, and adjusts the work it is doing. Acceptance means the message was queued, not that the change was made; the job can still finish first. Only running jobs can be steered.

post/api/spreadsheets/{runId}/steer

Request

  • Base URL
    https://api.shortcut.ai (the document declares no server; this is the origin it was published from)
  • Auth
    • HTTP bearer
    • or HTTP bearer
    • or API key in cookie shortcut_access_token
    • or HTTP bearer

Path parameters

runIdstring required

Unique run identifier

Request body

messagestring required

Instruction for the running agent, delivered at its next model turn

requestIdstring required

Caller-chosen id; repeating it does not deliver the message twice

Response

Default Response

runIdstring required
requestIdstring required
status'queued' required
messagestring required

Changes