Errors

Raised when API authentication fails (401, 403).

Raised when trying to operate on a non-existent sandbox (404).

Raised when hitting rate limits or concurrency limits (429). Includes limit and current attributes.

Raised when input validation fails (invalid parameters, empty code, etc.).

Raised when sandbox service has internal errors (500). Not retryable.

Raised when sandbox service is unavailable (502, 503). Retryable - includes retryable attribute.

Raised when unable to connect to the sandbox service.

Raised when a request or operation times out. Includes timeout_ms and operation attributes.

Raised when sandbox creation fails.

Raised when command or code execution fails.

Raised when API returns unexpected or malformed response.

Raised when a file is not found (local or remote). Includes path and is_local attributes.

Raised when trying to create or write a file that already exists (409). Includes path attribute.

Raised when a file is locked and cannot be accessed (423). Includes path attribute.

Raised when a file is busy and cannot be accessed (423 with FILE_BUSY code). Includes path attribute.

Raised when there is insufficient storage space for file operations (507). Includes path attribute.

Raised when file operation is denied due to permissions (403). Includes path attribute.

Raised when file type is not supported (415). Includes detail attribute with additional information.

Raised when file checksum verification fails. Includes path, expected, actual, algorithm, and direction attributes.

Base exception for all sandbox operations. Catch this to handle any sandbox-related error.

Base exception for client-side errors (4xx HTTP status codes). Indicates issues with the request.

Base exception for server-side errors (5xx HTTP status codes). Includes status_code and retryable attributes.

Base exception for network-related errors (connection failures, timeouts).

Base exception for file operation failures. Catch this to handle any file-related error.