Sign in
Agents

Execute ad-hoc agent

Creates an ephemeral agent and executes it immediately. By default this uses the lightweight synchronous linc runtime on Vercel Sandbox. Set agentRuntime: true to opt into the legacy Daytona-backed agent runtime.

post/agent/v2/execute

Request body

promptstring required
instructionsstring
modelstring
agentRuntimeboolean nullable

Set to true to opt into the legacy Daytona-backed agent runtime.

vaultIdsstring[] nullable
objectIdsstring[] nullable
guidancestring nullable
enabledToolsstring[] nullable
disabledToolsstring[] nullable

Response

Run completed or started

runIdstring
agentIdstring
status'running' | 'completed' | 'failed'
provider'daytona' | 'vercel'
runtimeIdstring nullable
runtimeState'running' | 'ended' | 'error'
outputstring nullable
errorstring nullable
usageobject nullable
messagestring nullable

Changes