Skip to main content
POST
/
v1
/
devboxes
/
{id}
/
execute
JavaScript
import Runloop from '@runloop/api-client';

const client = new Runloop({
  bearerToken: 'My Bearer Token',
});

const devboxAsyncExecutionDetailView = await client.devboxes.execute('id', {
  command: 'command',
  command_id: 'command_id',
});

console.log(devboxAsyncExecutionDetailView.devbox_id);
{
  "devbox_id": "<string>",
  "execution_id": "<string>",
  "status": "queued",
  "shell_name": "<string>",
  "stdout": "<string>",
  "stderr": "<string>",
  "exit_status": 123
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

The Devbox ID.

Query Parameters

​
last_n
string

Last n lines of standard error / standard out to return (default: 100)

Body

application/json
​
command_id
string
required

The command ID in UUIDv7 string format for idempotency and tracking

​
command
string
required

The command to execute via the Devbox shell. By default, commands are run from the user home directory unless shell_name is specified. If shell_name is specified the command is run from the directory based on the recent state of the persistent shell.

​
shell_name
string | null

The name of the persistent shell to create or use if already created. When using a persistent shell, the command will run from the directory at the end of the previous command and environment variables will be preserved.

​
optimistic_timeout
integer | null

Timeout in seconds to wait for command completion. Operation is not killed. Max is 600 seconds.

Response

OK

​
devbox_id
string
required

Devbox id where command was executed.

​
execution_id
string
required

Ephemeral id of the execution in progress.

​
status
enum<string>
required

Current status of the execution.

Available options:
queued,
running,
completed
​
shell_name
string | null

Shell name.

​
stdout
string | null

Standard out generated by command. This field will remain unset until the execution has completed.

​
stderr
string | null

Standard error generated by command. This field will remain unset until the execution has completed.

​
exit_status
integer | null

Exit code of command execution. This field will remain unset until the execution has completed.