# Errors (/docs/java-sdk/errors)

## DaytonaException [#daytonaexception]

Base exception for all Daytona SDK errors.

Subclasses map to specific HTTP status codes and allow callers to catch
precise failure conditions without string-parsing error messages:
```java
try {
Sandbox sandbox = daytona.sandbox().get("nonexistent-id");
} catch (DaytonaNotFoundException e) {
// sandbox does not exist
} catch (DaytonaAuthenticationException e) {
// invalid API key
} catch (DaytonaException e) {
// other SDK error
}
```

**Properties**:

- `SOURCE_API` _String_ - Wire-format `source` values set by the translation layer when a
Daytona service stamps them on the wire envelope. A `null`
`source` means the response did not carry a structured envelope
(treat as opaque).
- `SOURCE_DAEMON` _String_ -
- `SOURCE_PROXY` _String_ -

### Constructors [#constructors]

#### new DaytonaException() [#new-daytonaexception]
```java
public DaytonaException(String message)
```

Creates a generic Daytona exception.

**Parameters**:

- `message` _String_ - error description

#### new DaytonaException() [#new-daytonaexception-1]
```java
public DaytonaException(String message, Throwable cause)
```

Creates a generic Daytona exception with a cause.

**Parameters**:

- `message` _String_ - error description
- `cause` _Throwable_ - root cause

#### new DaytonaException() [#new-daytonaexception-2]
```java
public DaytonaException(int statusCode, String message)
```

Creates a Daytona exception with explicit HTTP status code.

**Parameters**:

- `statusCode` _int_ - HTTP status code
- `message` _String_ - error description

#### new DaytonaException() [#new-daytonaexception-3]
```java
public DaytonaException(int statusCode, String message, Throwable cause)
```

Creates a Daytona exception with explicit HTTP status code and a cause.

**Parameters**:

- `statusCode` _int_ - HTTP status code
- `message` _String_ - error description
- `cause` _Throwable_ - root cause

#### new DaytonaException() [#new-daytonaexception-4]
```java
public DaytonaException(int statusCode, String message, Map<String, String> headers)
```

Creates a Daytona exception with HTTP status code and headers.

**Parameters**:

- `statusCode` _int_ - HTTP status code
- `message` _String_ - error description
- `headers` _Map\<String, String\>_ - response headers

#### new DaytonaException() [#new-daytonaexception-5]
```java
public DaytonaException(int statusCode, String message, Map<String, String> headers, String code, String source)
```

Creates a Daytona exception with HTTP status code, headers, error code, and source.

**Parameters**:

- `statusCode` _int_ - HTTP status code
- `message` _String_ - error description
- `headers` _Map\<String, String\>_ - response headers
- `code` _String_ - machine-readable error code
- `source` _String_ - component that originated the error

#### new DaytonaException() [#new-daytonaexception-6]
```java
public DaytonaException(int statusCode, String message, String code, String source)
```

Creates a Daytona exception with HTTP status code, error code, and source.

**Parameters**:

- `statusCode` _int_ - HTTP status code
- `message` _String_ - error description
- `code` _String_ - machine-readable error code
- `source` _String_ - component that originated the error

#### new DaytonaException() [#new-daytonaexception-7]
```java
public DaytonaException(int statusCode, String message, Throwable cause, String code, String source)
```

Creates a Daytona exception with HTTP status code, cause, error code, and source.

**Parameters**:

- `statusCode` _int_ - HTTP status code
- `message` _String_ - error description
- `cause` _Throwable_ - root cause
- `code` _String_ - machine-readable error code
- `source` _String_ - component that originated the error

### Methods [#methods]

#### setPendingHeaders() [#setpendingheaders]
```java
public static void setPendingHeaders(Map<String, String> headers)
```

**Parameters**:

- `headers` _Map\<String, String\>_ -

#### clearPendingHeaders() [#clearpendingheaders]
```java
public static void clearPendingHeaders()
```

#### getStatusCode() [#getstatuscode]
```java
public int getStatusCode()
```

Returns the HTTP status code, or 0 if not applicable.

**Returns**:

- `int` -

#### getHeaders() [#getheaders]
```java
public Map<String, String> getHeaders()
```

Returns the HTTP response headers, or an empty map if not available.

**Returns**:

- `Map\<String, String\>` -

#### getCode() [#getcode]
```java
public String getCode()
```

Returns the machine-readable error code, or null if not available.

**Returns**:

- `String` -

#### getSource() [#getsource]
```java
public String getSource()
```

Returns the originating service from the wire envelope. `null`
for SDK-side errors and for responses that don't carry the envelope.
Otherwise one of `#SOURCE_API`, `#SOURCE_DAEMON` or
`#SOURCE_PROXY`.

**Returns**:

- `String` -

## DaytonaA11yUnavailableException [#daytonaa11yunavailableexception]

The accessibility (AT-SPI) bus is not reachable.

Subclass of `DaytonaServiceUnavailableException`.

### Constructors [#constructors-1]

#### new DaytonaA11yUnavailableException() [#new-daytonaa11yunavailableexception]
```java
public DaytonaA11yUnavailableException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaA11yUnavailableException() [#new-daytonaa11yunavailableexception-1]
```java
public DaytonaA11yUnavailableException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaA11yUnavailableException() [#new-daytonaa11yunavailableexception-2]
```java
public DaytonaA11yUnavailableException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaA11yUnavailableException() [#new-daytonaa11yunavailableexception-3]
```java
public DaytonaA11yUnavailableException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaAuthenticationException [#daytonaauthenticationexception]

Raised when API credentials are missing or invalid (HTTP 401).
```java
try {
daytona.sandbox().create();
} catch (DaytonaAuthenticationException e) {
System.err.println("Invalid or missing API key");
}
```

**Properties**:

- `STATUS_CODE` _int_ - HTTP status code carried by every instance of this class.

### Constructors [#constructors-2]

#### new DaytonaAuthenticationException() [#new-daytonaauthenticationexception]
```java
public DaytonaAuthenticationException(String message)
```

Creates an authentication exception.

**Parameters**:

- `message` _String_ - error description from the API

#### new DaytonaAuthenticationException() [#new-daytonaauthenticationexception-1]
```java
public DaytonaAuthenticationException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ - error description from the API
- `cause` _Throwable_ - root cause

#### new DaytonaAuthenticationException() [#new-daytonaauthenticationexception-2]
```java
public DaytonaAuthenticationException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaAuthenticationException() [#new-daytonaauthenticationexception-3]
```java
public DaytonaAuthenticationException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaBadGatewayException [#daytonabadgatewayexception]

Raised for HTTP 502 — an upstream dependency rejected or dropped the request.

**Properties**:

- `STATUS_CODE` _int_ -

### Constructors [#constructors-3]

#### new DaytonaBadGatewayException() [#new-daytonabadgatewayexception]
```java
public DaytonaBadGatewayException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaBadGatewayException() [#new-daytonabadgatewayexception-1]
```java
public DaytonaBadGatewayException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaBadGatewayException() [#new-daytonabadgatewayexception-2]
```java
public DaytonaBadGatewayException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaBadGatewayException() [#new-daytonabadgatewayexception-3]
```java
public DaytonaBadGatewayException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaBadRequestException [#daytonabadrequestexception]

Raised when the request is malformed or contains invalid parameters (HTTP 400).
```java
try {
daytona.sandbox().create(params);
} catch (DaytonaBadRequestException e) {
System.err.println("Invalid request parameters: " + e.getMessage());
}
```

**Properties**:

- `STATUS_CODE` _int_ - HTTP status code carried by every instance of this class.

### Constructors [#constructors-4]

#### new DaytonaBadRequestException() [#new-daytonabadrequestexception]
```java
public DaytonaBadRequestException(String message)
```

Creates a bad-request exception.

**Parameters**:

- `message` _String_ - error description from the API

#### new DaytonaBadRequestException() [#new-daytonabadrequestexception-1]
```java
public DaytonaBadRequestException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ - error description from the API
- `cause` _Throwable_ - root cause

#### new DaytonaBadRequestException() [#new-daytonabadrequestexception-2]
```java
public DaytonaBadRequestException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaBadRequestException() [#new-daytonabadrequestexception-3]
```java
public DaytonaBadRequestException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaCommandAlreadyCompletedException [#daytonacommandalreadycompletedexception]

The shell command already finished.

Subclass of `DaytonaGoneException`.

### Constructors [#constructors-5]

#### new DaytonaCommandAlreadyCompletedException() [#new-daytonacommandalreadycompletedexception]
```java
public DaytonaCommandAlreadyCompletedException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaCommandAlreadyCompletedException() [#new-daytonacommandalreadycompletedexception-1]
```java
public DaytonaCommandAlreadyCompletedException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaCommandAlreadyCompletedException() [#new-daytonacommandalreadycompletedexception-2]
```java
public DaytonaCommandAlreadyCompletedException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaCommandAlreadyCompletedException() [#new-daytonacommandalreadycompletedexception-3]
```java
public DaytonaCommandAlreadyCompletedException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaConflictException [#daytonaconflictexception]

Raised when an operation conflicts with the current state (HTTP 409).

Common causes: creating a resource with a name that already exists,
or performing an operation incompatible with the resource's current state.
```java
try {
daytona.snapshot().create(params);
} catch (DaytonaConflictException e) {
System.err.println("A snapshot with this name already exists");
}
```

**Properties**:

- `STATUS_CODE` _int_ - HTTP status code carried by every instance of this class.

### Constructors [#constructors-6]

#### new DaytonaConflictException() [#new-daytonaconflictexception]
```java
public DaytonaConflictException(String message)
```

Creates a conflict exception.

**Parameters**:

- `message` _String_ - error description from the API

#### new DaytonaConflictException() [#new-daytonaconflictexception-1]
```java
public DaytonaConflictException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ - error description from the API
- `cause` _Throwable_ - root cause

#### new DaytonaConflictException() [#new-daytonaconflictexception-2]
```java
public DaytonaConflictException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaConflictException() [#new-daytonaconflictexception-3]
```java
public DaytonaConflictException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaConnectionException [#daytonaconnectionexception]

Raised for network-level connection failures (no HTTP response received).

Raised when the SDK cannot reach the Daytona API due to network issues
such as DNS failure, connection refused, or TLS errors.
```java
try {
daytona.sandbox().create();
} catch (DaytonaConnectionException e) {
System.err.println("Cannot reach Daytona API: " + e.getMessage());
}
```

### Constructors [#constructors-7]

#### new DaytonaConnectionException() [#new-daytonaconnectionexception]
```java
public DaytonaConnectionException(String message)
```

Creates a connection exception.

**Parameters**:

- `message` _String_ - connection failure description

#### new DaytonaConnectionException() [#new-daytonaconnectionexception-1]
```java
public DaytonaConnectionException(String message, Throwable cause)
```

Creates a connection exception with a cause.

**Parameters**:

- `message` _String_ - connection failure description
- `cause` _Throwable_ - root cause

#### new DaytonaConnectionException() [#new-daytonaconnectionexception-2]
```java
public DaytonaConnectionException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaConnectionException() [#new-daytonaconnectionexception-3]
```java
public DaytonaConnectionException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaConnectionTimeoutException [#daytonaconnectiontimeoutexception]

Raised when the transport layer times out connecting to or reading from a
Daytona service. Subclass of `DaytonaConnectionException` so callers
can catch the broader "connection failed" category.

### Constructors [#constructors-8]

#### new DaytonaConnectionTimeoutException() [#new-daytonaconnectiontimeoutexception]
```java
public DaytonaConnectionTimeoutException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaConnectionTimeoutException() [#new-daytonaconnectiontimeoutexception-1]
```java
public DaytonaConnectionTimeoutException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaConnectionTimeoutException() [#new-daytonaconnectiontimeoutexception-2]
```java
public DaytonaConnectionTimeoutException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaConnectionTimeoutException() [#new-daytonaconnectiontimeoutexception-3]
```java
public DaytonaConnectionTimeoutException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaFileAccessDeniedException [#daytonafileaccessdeniedexception]

Insufficient permissions for the filesystem operation.

Subclass of `DaytonaForbiddenException`.

### Constructors [#constructors-9]

#### new DaytonaFileAccessDeniedException() [#new-daytonafileaccessdeniedexception]
```java
public DaytonaFileAccessDeniedException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaFileAccessDeniedException() [#new-daytonafileaccessdeniedexception-1]
```java
public DaytonaFileAccessDeniedException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaFileAccessDeniedException() [#new-daytonafileaccessdeniedexception-2]
```java
public DaytonaFileAccessDeniedException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaFileAccessDeniedException() [#new-daytonafileaccessdeniedexception-3]
```java
public DaytonaFileAccessDeniedException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaFileNotFoundException [#daytonafilenotfoundexception]

Filesystem entry was not found.

Subclass of `DaytonaNotFoundException`.

### Constructors [#constructors-10]

#### new DaytonaFileNotFoundException() [#new-daytonafilenotfoundexception]
```java
public DaytonaFileNotFoundException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaFileNotFoundException() [#new-daytonafilenotfoundexception-1]
```java
public DaytonaFileNotFoundException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaFileNotFoundException() [#new-daytonafilenotfoundexception-2]
```java
public DaytonaFileNotFoundException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaFileNotFoundException() [#new-daytonafilenotfoundexception-3]
```java
public DaytonaFileNotFoundException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaFileReadFailedException [#daytonafilereadfailedexception]

Daemon could not read the requested file (code `FILE_READ_FAILED`, HTTP 500).

Subclass of `DaytonaInternalServerException`.

### Constructors [#constructors-11]

#### new DaytonaFileReadFailedException() [#new-daytonafilereadfailedexception]
```java
public DaytonaFileReadFailedException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaFileReadFailedException() [#new-daytonafilereadfailedexception-1]
```java
public DaytonaFileReadFailedException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaFileReadFailedException() [#new-daytonafilereadfailedexception-2]
```java
public DaytonaFileReadFailedException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaFileReadFailedException() [#new-daytonafilereadfailedexception-3]
```java
public DaytonaFileReadFailedException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaForbiddenException [#daytonaforbiddenexception]

Raised when the authenticated user lacks permission to perform an operation (HTTP 403).
```java
try {
daytona.sandbox().delete(sandboxId);
} catch (DaytonaForbiddenException e) {
System.err.println("Not authorized to delete this sandbox");
}
```

**Properties**:

- `STATUS_CODE` _int_ - HTTP status code carried by every instance of this class.

### Constructors [#constructors-12]

#### new DaytonaForbiddenException() [#new-daytonaforbiddenexception]
```java
public DaytonaForbiddenException(String message)
```

Creates a forbidden exception.

**Parameters**:

- `message` _String_ - error description from the API

#### new DaytonaForbiddenException() [#new-daytonaforbiddenexception-1]
```java
public DaytonaForbiddenException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ - error description from the API
- `cause` _Throwable_ - root cause

#### new DaytonaForbiddenException() [#new-daytonaforbiddenexception-2]
```java
public DaytonaForbiddenException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaForbiddenException() [#new-daytonaforbiddenexception-3]
```java
public DaytonaForbiddenException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaGitAuthFailedException [#daytonagitauthfailedexception]

Git authentication credentials were rejected by the remote.

Subclass of `DaytonaAuthenticationException`.

### Constructors [#constructors-13]

#### new DaytonaGitAuthFailedException() [#new-daytonagitauthfailedexception]
```java
public DaytonaGitAuthFailedException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaGitAuthFailedException() [#new-daytonagitauthfailedexception-1]
```java
public DaytonaGitAuthFailedException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaGitAuthFailedException() [#new-daytonagitauthfailedexception-2]
```java
public DaytonaGitAuthFailedException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaGitAuthFailedException() [#new-daytonagitauthfailedexception-3]
```java
public DaytonaGitAuthFailedException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaGitBranchExistsException [#daytonagitbranchexistsexception]

A git branch with this name already exists.

Subclass of `DaytonaConflictException`.

### Constructors [#constructors-14]

#### new DaytonaGitBranchExistsException() [#new-daytonagitbranchexistsexception]
```java
public DaytonaGitBranchExistsException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaGitBranchExistsException() [#new-daytonagitbranchexistsexception-1]
```java
public DaytonaGitBranchExistsException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaGitBranchExistsException() [#new-daytonagitbranchexistsexception-2]
```java
public DaytonaGitBranchExistsException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaGitBranchExistsException() [#new-daytonagitbranchexistsexception-3]
```java
public DaytonaGitBranchExistsException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaGitBranchNotFoundException [#daytonagitbranchnotfoundexception]

The requested git branch does not exist.

Subclass of `DaytonaNotFoundException`.

### Constructors [#constructors-15]

#### new DaytonaGitBranchNotFoundException() [#new-daytonagitbranchnotfoundexception]
```java
public DaytonaGitBranchNotFoundException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaGitBranchNotFoundException() [#new-daytonagitbranchnotfoundexception-1]
```java
public DaytonaGitBranchNotFoundException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaGitBranchNotFoundException() [#new-daytonagitbranchnotfoundexception-2]
```java
public DaytonaGitBranchNotFoundException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaGitBranchNotFoundException() [#new-daytonagitbranchnotfoundexception-3]
```java
public DaytonaGitBranchNotFoundException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaGitDirtyWorktreeException [#daytonagitdirtyworktreeexception]

Worktree has uncommitted changes.

Subclass of `DaytonaConflictException`.

### Constructors [#constructors-16]

#### new DaytonaGitDirtyWorktreeException() [#new-daytonagitdirtyworktreeexception]
```java
public DaytonaGitDirtyWorktreeException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaGitDirtyWorktreeException() [#new-daytonagitdirtyworktreeexception-1]
```java
public DaytonaGitDirtyWorktreeException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaGitDirtyWorktreeException() [#new-daytonagitdirtyworktreeexception-2]
```java
public DaytonaGitDirtyWorktreeException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaGitDirtyWorktreeException() [#new-daytonagitdirtyworktreeexception-3]
```java
public DaytonaGitDirtyWorktreeException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaGitMergeConflictException [#daytonagitmergeconflictexception]

Git merge has conflicts that need manual resolution.

Subclass of `DaytonaConflictException`.

### Constructors [#constructors-17]

#### new DaytonaGitMergeConflictException() [#new-daytonagitmergeconflictexception]
```java
public DaytonaGitMergeConflictException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaGitMergeConflictException() [#new-daytonagitmergeconflictexception-1]
```java
public DaytonaGitMergeConflictException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaGitMergeConflictException() [#new-daytonagitmergeconflictexception-2]
```java
public DaytonaGitMergeConflictException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaGitMergeConflictException() [#new-daytonagitmergeconflictexception-3]
```java
public DaytonaGitMergeConflictException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaGitPushRejectedException [#daytonagitpushrejectedexception]

Git push was rejected (non-fast-forward / stale ref).

Subclass of `DaytonaConflictException`.

### Constructors [#constructors-18]

#### new DaytonaGitPushRejectedException() [#new-daytonagitpushrejectedexception]
```java
public DaytonaGitPushRejectedException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaGitPushRejectedException() [#new-daytonagitpushrejectedexception-1]
```java
public DaytonaGitPushRejectedException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaGitPushRejectedException() [#new-daytonagitpushrejectedexception-2]
```java
public DaytonaGitPushRejectedException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaGitPushRejectedException() [#new-daytonagitpushrejectedexception-3]
```java
public DaytonaGitPushRejectedException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaGitRemoteRejectedException [#daytonagitremoterejectedexception]

The git remote rejected the operation (hooks, branch protection or quota).

Subclass of `DaytonaUnprocessableEntityException`.

### Constructors [#constructors-19]

#### new DaytonaGitRemoteRejectedException() [#new-daytonagitremoterejectedexception]
```java
public DaytonaGitRemoteRejectedException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaGitRemoteRejectedException() [#new-daytonagitremoterejectedexception-1]
```java
public DaytonaGitRemoteRejectedException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaGitRemoteRejectedException() [#new-daytonagitremoterejectedexception-2]
```java
public DaytonaGitRemoteRejectedException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaGitRemoteRejectedException() [#new-daytonagitremoterejectedexception-3]
```java
public DaytonaGitRemoteRejectedException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaGitRepoNotFoundException [#daytonagitreponotfoundexception]

The requested git repository does not exist.

Subclass of `DaytonaNotFoundException`.

### Constructors [#constructors-20]

#### new DaytonaGitRepoNotFoundException() [#new-daytonagitreponotfoundexception]
```java
public DaytonaGitRepoNotFoundException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaGitRepoNotFoundException() [#new-daytonagitreponotfoundexception-1]
```java
public DaytonaGitRepoNotFoundException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaGitRepoNotFoundException() [#new-daytonagitreponotfoundexception-2]
```java
public DaytonaGitRepoNotFoundException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaGitRepoNotFoundException() [#new-daytonagitreponotfoundexception-3]
```java
public DaytonaGitRepoNotFoundException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaGitTransportFailedException [#daytonagittransportfailedexception]

The git remote was unreachable (DNS, TLS, connection or timeout failure).

Subclass of `DaytonaBadGatewayException`.

### Constructors [#constructors-21]

#### new DaytonaGitTransportFailedException() [#new-daytonagittransportfailedexception]
```java
public DaytonaGitTransportFailedException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaGitTransportFailedException() [#new-daytonagittransportfailedexception-1]
```java
public DaytonaGitTransportFailedException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaGitTransportFailedException() [#new-daytonagittransportfailedexception-2]
```java
public DaytonaGitTransportFailedException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaGitTransportFailedException() [#new-daytonagittransportfailedexception-3]
```java
public DaytonaGitTransportFailedException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaGoneException [#daytonagoneexception]

Raised for HTTP 410 — the target resource is permanently gone.

**Properties**:

- `STATUS_CODE` _int_ -

### Constructors [#constructors-22]

#### new DaytonaGoneException() [#new-daytonagoneexception]
```java
public DaytonaGoneException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaGoneException() [#new-daytonagoneexception-1]
```java
public DaytonaGoneException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaGoneException() [#new-daytonagoneexception-2]
```java
public DaytonaGoneException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaGoneException() [#new-daytonagoneexception-3]
```java
public DaytonaGoneException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaInternalServerException [#daytonainternalserverexception]

Raised for HTTP 500 — server-side bug or unhandled condition.

**Properties**:

- `STATUS_CODE` _int_ -

### Constructors [#constructors-23]

#### new DaytonaInternalServerException() [#new-daytonainternalserverexception]
```java
public DaytonaInternalServerException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaInternalServerException() [#new-daytonainternalserverexception-1]
```java
public DaytonaInternalServerException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaInternalServerException() [#new-daytonainternalserverexception-2]
```java
public DaytonaInternalServerException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaInternalServerException() [#new-daytonainternalserverexception-3]
```java
public DaytonaInternalServerException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaInvalidFilePathException [#daytonainvalidfilepathexception]

Supplied file path was rejected by the daemon (code `INVALID_FILE_PATH`, HTTP 400).

Subclass of `DaytonaBadRequestException`.

### Constructors [#constructors-24]

#### new DaytonaInvalidFilePathException() [#new-daytonainvalidfilepathexception]
```java
public DaytonaInvalidFilePathException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaInvalidFilePathException() [#new-daytonainvalidfilepathexception-1]
```java
public DaytonaInvalidFilePathException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaInvalidFilePathException() [#new-daytonainvalidfilepathexception-2]
```java
public DaytonaInvalidFilePathException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaInvalidFilePathException() [#new-daytonainvalidfilepathexception-3]
```java
public DaytonaInvalidFilePathException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaLspServerNotInitializedException [#daytonalspservernotinitializedexception]

LSP server must be started via /lsp/start first.

Subclass of `DaytonaBadRequestException`.

### Constructors [#constructors-25]

#### new DaytonaLspServerNotInitializedException() [#new-daytonalspservernotinitializedexception]
```java
public DaytonaLspServerNotInitializedException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaLspServerNotInitializedException() [#new-daytonalspservernotinitializedexception-1]
```java
public DaytonaLspServerNotInitializedException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaLspServerNotInitializedException() [#new-daytonalspservernotinitializedexception-2]
```java
public DaytonaLspServerNotInitializedException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaLspServerNotInitializedException() [#new-daytonalspservernotinitializedexception-3]
```java
public DaytonaLspServerNotInitializedException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaNotFoundException [#daytonanotfoundexception]

Raised when a requested resource does not exist (HTTP 404).

**Properties**:

- `STATUS_CODE` _int_ - HTTP status code carried by every instance of this class.

### Constructors [#constructors-26]

#### new DaytonaNotFoundException() [#new-daytonanotfoundexception]
```java
public DaytonaNotFoundException(String message)
```

Creates a not-found exception.

**Parameters**:

- `message` _String_ - error description from the API

#### new DaytonaNotFoundException() [#new-daytonanotfoundexception-1]
```java
public DaytonaNotFoundException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ - error description from the API
- `cause` _Throwable_ - root cause

#### new DaytonaNotFoundException() [#new-daytonanotfoundexception-2]
```java
public DaytonaNotFoundException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaNotFoundException() [#new-daytonanotfoundexception-3]
```java
public DaytonaNotFoundException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaProcessExecutionTimeoutException [#daytonaprocessexecutiontimeoutexception]

A process exceeded its configured execution timeout.

Subclass of `DaytonaTimeoutException`.

### Constructors [#constructors-27]

#### new DaytonaProcessExecutionTimeoutException() [#new-daytonaprocessexecutiontimeoutexception]
```java
public DaytonaProcessExecutionTimeoutException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaProcessExecutionTimeoutException() [#new-daytonaprocessexecutiontimeoutexception-1]
```java
public DaytonaProcessExecutionTimeoutException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaProcessExecutionTimeoutException() [#new-daytonaprocessexecutiontimeoutexception-2]
```java
public DaytonaProcessExecutionTimeoutException(int statusCode, String message, String code, String source)
```

**Parameters**:

- `statusCode` _int_ -
- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaProcessExecutionTimeoutException() [#new-daytonaprocessexecutiontimeoutexception-3]
```java
public DaytonaProcessExecutionTimeoutException(int statusCode, String message, Throwable cause, String code, String source)
```

**Parameters**:

- `statusCode` _int_ -
- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaProcessExecutionTimeoutException() [#new-daytonaprocessexecutiontimeoutexception-4]
```java
public DaytonaProcessExecutionTimeoutException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaProcessExecutionTimeoutException() [#new-daytonaprocessexecutiontimeoutexception-5]
```java
public DaytonaProcessExecutionTimeoutException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaProcessNotFoundException [#daytonaprocessnotfoundexception]

The requested process is not running.

Subclass of `DaytonaNotFoundException`.

### Constructors [#constructors-28]

#### new DaytonaProcessNotFoundException() [#new-daytonaprocessnotfoundexception]
```java
public DaytonaProcessNotFoundException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaProcessNotFoundException() [#new-daytonaprocessnotfoundexception-1]
```java
public DaytonaProcessNotFoundException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaProcessNotFoundException() [#new-daytonaprocessnotfoundexception-2]
```java
public DaytonaProcessNotFoundException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaProcessNotFoundException() [#new-daytonaprocessnotfoundexception-3]
```java
public DaytonaProcessNotFoundException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaQueueTimeoutException [#daytonaqueuetimeoutexception]

Thrown when a Sandbox was destroyed by the API because it waited longer than its queue timeout
for a runner.

### Constructors [#constructors-29]

#### new DaytonaQueueTimeoutException() [#new-daytonaqueuetimeoutexception]
```java
public DaytonaQueueTimeoutException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaQueueTimeoutException() [#new-daytonaqueuetimeoutexception-1]
```java
public DaytonaQueueTimeoutException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaQueueTimeoutException() [#new-daytonaqueuetimeoutexception-2]
```java
public DaytonaQueueTimeoutException(int statusCode, String message, String code, String source)
```

**Parameters**:

- `statusCode` _int_ -
- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaQueueTimeoutException() [#new-daytonaqueuetimeoutexception-3]
```java
public DaytonaQueueTimeoutException(int statusCode, String message, Throwable cause, String code, String source)
```

**Parameters**:

- `statusCode` _int_ -
- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaQueueTimeoutException() [#new-daytonaqueuetimeoutexception-4]
```java
public DaytonaQueueTimeoutException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaQueueTimeoutException() [#new-daytonaqueuetimeoutexception-5]
```java
public DaytonaQueueTimeoutException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaRateLimitException [#daytonaratelimitexception]

Raised when API rate limits are exceeded (HTTP 429).

**Properties**:

- `STATUS_CODE` _int_ - HTTP status code carried by every instance of this class.

### Constructors [#constructors-30]

#### new DaytonaRateLimitException() [#new-daytonaratelimitexception]
```java
public DaytonaRateLimitException(String message)
```

Creates a rate-limit exception.

**Parameters**:

- `message` _String_ - error description from the API

#### new DaytonaRateLimitException() [#new-daytonaratelimitexception-1]
```java
public DaytonaRateLimitException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ - error description from the API
- `cause` _Throwable_ - root cause

#### new DaytonaRateLimitException() [#new-daytonaratelimitexception-2]
```java
public DaytonaRateLimitException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaRateLimitException() [#new-daytonaratelimitexception-3]
```java
public DaytonaRateLimitException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaRecordingFfmpegNotFoundException [#daytonarecordingffmpegnotfoundexception]

ffmpeg binary is not installed; required for recording.

Subclass of `DaytonaServiceUnavailableException`.

### Constructors [#constructors-31]

#### new DaytonaRecordingFfmpegNotFoundException() [#new-daytonarecordingffmpegnotfoundexception]
```java
public DaytonaRecordingFfmpegNotFoundException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaRecordingFfmpegNotFoundException() [#new-daytonarecordingffmpegnotfoundexception-1]
```java
public DaytonaRecordingFfmpegNotFoundException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaRecordingFfmpegNotFoundException() [#new-daytonarecordingffmpegnotfoundexception-2]
```java
public DaytonaRecordingFfmpegNotFoundException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaRecordingFfmpegNotFoundException() [#new-daytonarecordingffmpegnotfoundexception-3]
```java
public DaytonaRecordingFfmpegNotFoundException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaRecordingStillActiveException [#daytonarecordingstillactiveexception]

The recording is still running; stop it first.

Subclass of `DaytonaConflictException`.

### Constructors [#constructors-32]

#### new DaytonaRecordingStillActiveException() [#new-daytonarecordingstillactiveexception]
```java
public DaytonaRecordingStillActiveException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaRecordingStillActiveException() [#new-daytonarecordingstillactiveexception-1]
```java
public DaytonaRecordingStillActiveException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaRecordingStillActiveException() [#new-daytonarecordingstillactiveexception-2]
```java
public DaytonaRecordingStillActiveException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaRecordingStillActiveException() [#new-daytonarecordingstillactiveexception-3]
```java
public DaytonaRecordingStillActiveException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaServerException [#daytonaserverexception]

Raised for unexpected server-side failures (HTTP 5xx).

These are typically transient and safe to retry with exponential backoff.
```java
try {
daytona.sandbox().create();
} catch (DaytonaServerException e) {
System.err.println("Server error (status " + e.getStatusCode() + "), retry later");
}
```

### Constructors [#constructors-33]

#### new DaytonaServerException() [#new-daytonaserverexception]
```java
public DaytonaServerException(int statusCode, String message)
```

Creates a server exception.

**Parameters**:

- `statusCode` _int_ - HTTP status code (typically 5xx)
- `message` _String_ - error description from the API

#### new DaytonaServerException() [#new-daytonaserverexception-1]
```java
public DaytonaServerException(int statusCode, String message, Throwable cause)
```

**Parameters**:

- `statusCode` _int_ - HTTP status code (typically 5xx)
- `message` _String_ - error description from the API
- `cause` _Throwable_ - root cause

#### new DaytonaServerException() [#new-daytonaserverexception-2]
```java
public DaytonaServerException(int statusCode, String message, String code, String source)
```

**Parameters**:

- `statusCode` _int_ -
- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaServerException() [#new-daytonaserverexception-3]
```java
public DaytonaServerException(int statusCode, String message, Throwable cause, String code, String source)
```

**Parameters**:

- `statusCode` _int_ -
- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaServiceUnavailableException [#daytonaserviceunavailableexception]

Raised for HTTP 503 — the service is temporarily refusing traffic.

**Properties**:

- `STATUS_CODE` _int_ -

### Constructors [#constructors-34]

#### new DaytonaServiceUnavailableException() [#new-daytonaserviceunavailableexception]
```java
public DaytonaServiceUnavailableException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaServiceUnavailableException() [#new-daytonaserviceunavailableexception-1]
```java
public DaytonaServiceUnavailableException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaServiceUnavailableException() [#new-daytonaserviceunavailableexception-2]
```java
public DaytonaServiceUnavailableException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaServiceUnavailableException() [#new-daytonaserviceunavailableexception-3]
```java
public DaytonaServiceUnavailableException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaSessionEndedException [#daytonasessionendedexception]

The shell session has ended.

Subclass of `DaytonaGoneException`.

### Constructors [#constructors-35]

#### new DaytonaSessionEndedException() [#new-daytonasessionendedexception]
```java
public DaytonaSessionEndedException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaSessionEndedException() [#new-daytonasessionendedexception-1]
```java
public DaytonaSessionEndedException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaSessionEndedException() [#new-daytonasessionendedexception-2]
```java
public DaytonaSessionEndedException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaSessionEndedException() [#new-daytonasessionendedexception-3]
```java
public DaytonaSessionEndedException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaSpotEvictedException [#daytonaspotevictedexception]

Thrown when a Sandbox was destroyed by spot preemption.

Detected client-side while waiting for a sandbox state; subclass of `DaytonaException`.

### Constructors [#constructors-36]

#### new DaytonaSpotEvictedException() [#new-daytonaspotevictedexception]
```java
public DaytonaSpotEvictedException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaSpotEvictedException() [#new-daytonaspotevictedexception-1]
```java
public DaytonaSpotEvictedException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

## DaytonaTimeoutException [#daytonatimeoutexception]

Raised when an SDK operation times out.

Client-side transport timeouts default to HTTP 408, but mapped HTTP 504
(or any server-supplied timeout status) is preserved when available.

**Properties**:

- `STATUS_CODE` _int_ -

### Constructors [#constructors-37]

#### new DaytonaTimeoutException() [#new-daytonatimeoutexception]
```java
public DaytonaTimeoutException(String message, Throwable cause)
```

Creates a timeout exception with a cause.

**Parameters**:

- `message` _String_ - timeout description
- `cause` _Throwable_ - root cause

#### new DaytonaTimeoutException() [#new-daytonatimeoutexception-1]
```java
public DaytonaTimeoutException(String message)
```

Creates a timeout exception.

**Parameters**:

- `message` _String_ - timeout description

#### new DaytonaTimeoutException() [#new-daytonatimeoutexception-2]
```java
public DaytonaTimeoutException(int statusCode, String message, String code, String source)
```

**Parameters**:

- `statusCode` _int_ -
- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaTimeoutException() [#new-daytonatimeoutexception-3]
```java
public DaytonaTimeoutException(int statusCode, String message, Throwable cause, String code, String source)
```

**Parameters**:

- `statusCode` _int_ -
- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaTimeoutException() [#new-daytonatimeoutexception-4]
```java
public DaytonaTimeoutException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaTimeoutException() [#new-daytonatimeoutexception-5]
```java
public DaytonaTimeoutException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaUnprocessableEntityException [#daytonaunprocessableentityexception]

Raised for HTTP 422 — the request is well-formed but semantically invalid
(e.g. unsupported resource class, invalid configuration values).
```java
try {
daytona.sandbox().create(params);
} catch (DaytonaUnprocessableEntityException e) {
System.err.println("Unprocessable entity: " + e.getMessage());
}
```

**Properties**:

- `STATUS_CODE` _int_ - HTTP status code carried by every instance of this class.

### Constructors [#constructors-38]

#### new DaytonaUnprocessableEntityException() [#new-daytonaunprocessableentityexception]
```java
public DaytonaUnprocessableEntityException(String message)
```

**Parameters**:

- `message` _String_ -

#### new DaytonaUnprocessableEntityException() [#new-daytonaunprocessableentityexception-1]
```java
public DaytonaUnprocessableEntityException(String message, Throwable cause)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -

#### new DaytonaUnprocessableEntityException() [#new-daytonaunprocessableentityexception-2]
```java
public DaytonaUnprocessableEntityException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaUnprocessableEntityException() [#new-daytonaunprocessableentityexception-3]
```java
public DaytonaUnprocessableEntityException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -

## DaytonaValidationException [#daytonavalidationexception]

Raised for semantic validation failures (HTTP 422).

The mapper throws this subclass for 422 responses so that pre-existing
`catch (DaytonaValidationException e)` blocks keep matching, while
`catch (DaytonaUnprocessableEntityException e)` also matches via the
parent class.

Exists for backward compatibility only. Deleting this class (and
switching the 422 case in `ExceptionMapper` back to the parent) is
the whole removal.

**Deprecated**: Use `DaytonaUnprocessableEntityException` instead.

### Constructors [#constructors-39]

#### new DaytonaValidationException() [#new-daytonavalidationexception]
```java
public DaytonaValidationException(String message)
```

Creates a validation exception.

**Parameters**:

- `message` _String_ - error description

#### new DaytonaValidationException() [#new-daytonavalidationexception-1]
```java
public DaytonaValidationException(String message, Throwable cause)
```

Creates a validation exception with a cause.

**Parameters**:

- `message` _String_ - error description
- `cause` _Throwable_ - root cause

#### new DaytonaValidationException() [#new-daytonavalidationexception-2]
```java
public DaytonaValidationException(String message, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `code` _String_ -
- `source` _String_ -

#### new DaytonaValidationException() [#new-daytonavalidationexception-3]
```java
public DaytonaValidationException(String message, Throwable cause, String code, String source)
```

**Parameters**:

- `message` _String_ -
- `cause` _Throwable_ -
- `code` _String_ -
- `source` _String_ -