API ReferenceRuntimes

Create Runtime Invocation

View as Markdown
Submit durable AI work to a live runtime using the simplified invocation contract.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

runtimeIdstringRequired

Headers

Idempotency-KeystringOptional1-200 characters

Optional retry key for this billable operation. Reusing the same key with the same request replays the original successful response; reusing it with a different request returns 409.

Request

This endpoint expects an object.
actobjectRequired
OR
browserUseobjectRequired
OR
extractobjectRequired
OR
observeobjectRequired
OR
solveCaptchaobjectRequired
OR
stagehandAgentobjectRequired

Response

Accepted
actionenum
createdAtstring
idstringformat: "uuid"
runIdstringformat: "uuid"
runtimeIdstringformat: "uuid"
statusenum
durationMsinteger or null0-9007199254740991
errorobject or null
finishedAtstring or null
outputany

Any valid JSON value: object, array, string, number, boolean, or null.

startedAtstring or null

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error