Error codes

Every sandboxio exception carries one of these codes, a hint with the exact fix, and a link to its page here. Codes are stable across releases (spec/04, ADR-0010).

Code	Class	Meaning
SBX_E1000	ConfigurationError	The request could not be understood: bad DSN parameter, unknown key, bad option.
SBX_E1001	BackendNotFound	No backend is registered under that name.
SBX_E1002	BackendNotInstalled	A first-party backend whose extra is not installed.
SBX_E1101	CapabilityNotSupported	The backend does not declare the capability this call needs (spec/01 rule 2).
SBX_E1201	CreationError	The backend failed to produce a usable sandbox.
SBX_E1202	ConnectError	The backend would not service a sandbox-management call.
SBX_E1203	CreateTimeout	create() exceeded its timeout before the sandbox became usable.
SBX_E1204	SandboxGone	The sandbox no longer exists — its lifetime ended or the backend reclaimed it.
SBX_E1301	ExecutionError	A command exited non-zero and the caller asked for that to raise.
SBX_E1302	ExecutionTimeout	run(), run_code() or a stream exceeded its timeout; the process was killed.
SBX_E1401	NetworkPolicyViolation	Sandboxed code attempted egress the NetworkPolicy denies.
SBX_E1402	ResourceLimitExceeded	A Resources cap was hit.
SBX_E1501	AuthError	A provider credential is missing or rejected.
SBX_E1502	RateLimitError	The provider throttled the request. sandboxio does not retry on your behalf in v0.1.
SBX_E1601	AuditSinkError	An audit sink failed and on_sink_failure="fail" was configured.
SBX_E1700	FileSystemError	A sandbox filesystem operation failed for a reason other than a missing path.
SBX_E1701	PathNotFound	The sandbox-internal path does not exist.