Skip to content

Run a shell command in the actor's sandbox session

POST
/api/workspaces/{workspaceId}/apps-v2/{id}/exec

Executes in the session working tree via the configured sandbox provider, then flushes the working tree to the durable WIP ref.

workspaceId
required
string
id
required
string
object
command
required
string
>= 1 characters
cwd
string
timeoutMs
integer
> 0 <= 600000

Successful response

object
success

Whether the request succeeded.

boolean
data

Endpoint-specific response payload.

message
string
Example
Operation completed
error
string
Example
Error message

Invalid request

object
success
boolean
error
string
Example
Error message

Internal server error

object
success
boolean
error
string
Example
Error message