Skip to navigation

Delegate a task to the Runtype operator agent

Start a task the operator agent works through in your organization: it reads and changes agents, flows, records, tools, evals and surfaces with the same authority as the caller. With waitSeconds the response waits up to that long for the task to finish or to stop on a question (input_required) before answering; otherwise it returns the queued task at once. An identical delegation from the same caller that is still running is returned again (200, deduplicated: true) instead of starting a second one. API keys need DELEGATE_TASKS:WRITE.

Authentication

AuthorizationBearer
API key or Clerk session token

Request

This endpoint expects an object.
instructionstringRequired1-20000 characters
allowDestructivebooleanOptional
allowSimulationRunbooleanOptional

Permit starting simulation runs, each with a stated maxSpendUsd of at most $25, and no other gated operation. allowDestructive also permits them.

attachmentslist of objectsOptional

One image for the worker to read on its first turn. otto tasks only.

clientNamestringOptional<=64 characters
clientVersionstringOptional<=64 characters
contextanyOptional
maxToolCallsintegerOptional1-200
priorityenumOptional

Execution speed. standard (the default) runs at normal speed; fast runs at a higher speed for tasks that need it. Applies when creating a task.

Allowed values:
targetenumOptional

Who works the task. Defaults to operator; otto hands it to Otto, the account’s saved product-engineer agent, and needs the delegate-to-otto account flag.

Allowed values:
waitSecondsintegerOptional0-240

Response

The still-running task this request duplicated

apiKeyIdstring or null
clientNamestring or null
clientVersionstring or null
completedAtstring or null
createdAtstring
errorstring or null
idstring
instructionstring
lastEventSeqinteger>=0
modelRoundCountinteger>=0
organizationIdstring
questionstring or null
resultobject or null
startedAtstring or null
statusenum
summarystring or null
toolCallCountinteger>=0
totalCostdouble or null
touchedEntitieslist of objects
updatedAtstring
userIdstring
allowDestructivebooleanOptional
Whether the caller allowed destructive and consequential operations.
allowSimulationRunbooleanOptional
Whether the caller allowed starting simulation runs, and no other gated operation.
attachmentCountintegerOptional>=0

Images the task started with; read each from its attachment route.

contextanyOptional
deduplicatedbooleanOptional
True when an identical delegation from the same caller was still running, so that task was returned instead of starting another.
priorityenumOptional
Allowed values:
targetenumOptional

Who works the task; operator when absent.

Allowed values:
targetExecutionIdstring or nullOptional

The worker’s execution for the latest turn, when it has its own: an Otto run.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
413
Content Too Large Error
503
Service Unavailable Error