Overview
UseZombie uses structured error codes prefixed withUZ- to classify failures. Every failed request, run, or stage includes an error code in the API response, logs, and metrics. Use this reference to diagnose and remediate failures.
The API error codes page is the canonical list of every code and its HTTP status. This page adds operator-facing remediation for the subset that shows up in executor and worker telemetry.
Executor errors
Errors originating from the executor or agent runtime.| Code | Meaning | Remediation |
|---|---|---|
UZ-EXEC-001 | Execution session create failed | The executor could not create a new execution session. Check runner availability with zombied doctor worker. |
UZ-EXEC-002 | Stage start failed | The stage failed to start. Check runner configuration and executor logs for the underlying error. |
UZ-EXEC-003 | Execution timeout kill | The execution exceeded its timeout and was killed. Increase the timeout or simplify the spec. |
UZ-EXEC-009 | Execution startup posture failure | The per-run sandbox posture check failed. Verify the runner’s security configuration (Landlock, cgroups v2, network namespace). |
UZ-EXEC-012 | Runner agent init failed | The runner agent failed to initialize. Check configuration and executor logs. |
UZ-EXEC-013 | Runner agent run failed | The runner agent exited with an error during execution. Check logs for details. |
UZ-EXEC-014 | Runner invalid config | The runner configuration is invalid. Check config_json fields against the runner schema. |
Credential errors
Errors related to credential retrieval or validation.| Code | Meaning | Remediation |
|---|---|---|
UZ-CRED-001 | Anthropic API key missing | The workspace has no anthropic_api_key in the vault. Set one via the credentials API. |
UZ-CRED-003 | Platform LLM key missing | No active platform LLM key is configured. An admin must set one via the platform-keys API. |
Startup errors
Errors that prevent the API or worker from starting. These surface in systemd logs rather than run output.| Code | Meaning | Remediation |
|---|---|---|
UZ-STARTUP-001 | Environment check failed | Required environment variables are missing. Run zombied doctor to see which ones. |
UZ-STARTUP-002 | Config load failed | Configuration failed to load. Check that all required env vars are set. |
UZ-STARTUP-003 | Database connect failed | The database is unreachable. Verify DATABASE_URL and that the database accepts connections. |
UZ-STARTUP-004 | Redis connect failed | Redis is unreachable. Verify REDIS_URL_API and REDIS_URL_WORKER. |
UZ-STARTUP-005 | Migration check failed | Database migration state could not be verified. Check DB connectivity. |
UZ-STARTUP-007 | Redis group creation failed | Redis connected but consumer group creation failed. Check Redis ACL permissions. |