Sign in

v49

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01151216390.1 KB
Devbox
Devbox-ShellTools

Wait for an asynchronous execution to reach a specific status.

Polls the asynchronous execution's status until it reaches one of the desired statuses or times out. Max is 25 seconds.

post/v1/devboxes/{devbox_id}/executions/{execution_id}/wait_for_status

Path parameters

devbox_idstring required

The Devbox ID.

execution_idstring required

The Async Execution ID.

Query parameters

last_nstring

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

Request body

statusesDevboxExecutionStatus[] required

The command execution statuses to wait for. At least one status must be provided. The command will be returned as soon as it reaches any of the provided statuses.

timeout_secondsinteger nullable

(Optional) Timeout in seconds to wait for the status, up to 25 seconds. Defaults to 25 seconds.

Response

OK

devbox_idstring required

Devbox id where command was executed.

execution_idstring required

Ephemeral id of the execution in progress.

status'queued' | 'running' | 'completed' required
shell_namestring nullable

Shell name.

stdoutstring nullable

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

stderrstring nullable

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

exit_statusinteger nullable

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

stdout_truncatedboolean nullable

Indicates whether the stdout was truncated due to size limits.

stderr_truncatedboolean nullable

Indicates whether the stderr was truncated due to size limits.