花
Hanabi Developer Hub
/
Help
/
Error codes
Search
⌘K
Docs
Reference
Error codes
Every stable
HANABI-XXXX
code the platform can return — what it means and how to fix it.
64
codes
8
families
/
All
64
Permission & capability
4
Files & folders
6
Worker & sandbox
8
Network & egress
7
Validation & packaging
12
Quota
9
Module lifecycle
10
Account & sign-in
8
Families
Permission & capability
4
Files & folders
6
Worker & sandbox
8
Network & egress
7
Validation & packaging
12
Quota
9
Module lifecycle
10
Account & sign-in
8
Permission & capability
HANABI-P…
· 4
Capability declared, granted, or consented.
HANABI-P001
PERMISSION_DENIED
Permission not declared
Fix
Add the permission to `permissions` in hanabi.module.json, then repackage and reinstall.
HANABI-P002
PERMISSION_DENIED
Capability not granted
Fix
For admin/admin-HIGH capabilities, have an admin grant it in the Developer Portal review; for consent capabilities, approve the prompt.
HANABI-P003
PERMISSION_DENIED
User consent required
Fix
Request consent at first use; the user must accept the prompt before the call succeeds.
HANABI-P004
Module route not accessible
Fix
Only call your module's own server routes via moduleRequest(); use the dedicated SDK methods for platform capabilities.
Files & folders
HANABI-F…
· 6
The virtual file system and scope.
HANABI-F001
NOT_FOUND
File not found
Fix
Check the file id you passed; list files with pickFile() to get valid ids.
HANABI-F002
OUT_OF_SCOPE
File outside module scope
Fix
Operate only on files in your module's own folders, or request files.read.all / files.write.all (consent-gated) for the wider workspace.
HANABI-F003
No writable folder
Fix
Declare a folder with role 'output' or 'workspace' in your manifest's `filesystem.folders`.
HANABI-F004
File too large
Fix
Use the streaming worker contract (run_streaming) for large files, or split the input.
HANABI-F005
Unsafe file name
Fix
Use a bare file name (no slashes or '..'); the platform writes it into your module's folder.
HANABI-F006
Folder not found
Fix
Check the folder id; folders come from your manifest's filesystem.folders.
Worker & sandbox
HANABI-W…
· 8
The optional Python worker half.
HANABI-W001
Worker entrypoint missing
Fix
Add `entrypoints.worker` to your manifest and include that file in the package.
HANABI-W002
Worker code unavailable
Fix
Re-publish the package; the stored build may be missing or corrupt.
HANABI-W003
Worker crashed
Fix
Read the traceback in the debugger; handle the failing input and return a clear error.
HANABI-W004
Worker timed out
Fix
Optimise the worker, process less per job, or request a larger resource tier (worker.execute quota).
HANABI-W005
Worker out of memory
Fix
Stream large files (run_streaming) instead of loading them whole, or request a larger tier.
HANABI-W006
Too many output files
Fix
Bundle outputs (e.g. into a zip) or request a larger tier.
HANABI-W007
Worker output too large
Fix
Produce smaller output or request a larger tier.
HANABI-W008
Worker entry escapes module
Fix
Use a relative `entrypoints.worker` path inside your package (no '..' or absolute paths).
Network & egress
HANABI-N…
· 7
Outbound fetch and egress rules.
HANABI-N001
Network origin not approved
Fix
List the origin under `dependencies.services` and request network.fetch, or request network.fetch.broad for open egress.
HANABI-N002
Private/loopback host blocked
Fix
Fetch only public hosts; the platform never lets a worker reach internal addresses.
HANABI-N003
HTTP method not allowed
Fix
Use GET/POST (and the other allowed verbs); see the worker guide.
HANABI-N004
Not an http(s) URL
Fix
Pass an absolute https:// URL.
HANABI-N005
Egress budget exceeded
Fix
Reduce how much you download, or ask an admin to raise the egress_mb quota.
HANABI-N006
Egress rate limit exceeded
Fix
Slow down requests, or ask an admin to raise the rate_per_min quota.
HANABI-N007
PERMISSION_DENIED
Network not approved
Fix
Request the network.fetch permission and declare your service origins.
Validation & packaging
HANABI-V…
· 12
Manifest schema and packaging.
HANABI-V001
INVALID
Invalid manifest
Fix
Fix the reported field(s); see docs/modules/manifest-reference.md.
HANABI-V002
INVALID
Wrong schema version
Fix
Set schema_version to the current value shown in the manifest reference.
HANABI-V003
INVALID
Invalid module id
Fix
Rename id to e.g. 'my-module'.
HANABI-V004
Missing required field
Fix
Add the missing field; the message names which one.
HANABI-V005
Unknown permission
Fix
Use only permissions from the capability registry (see capability-api.md).
HANABI-V006
Invalid filesystem
Fix
Keep every folder under `filesystem.root` (which must be under Modules/).
HANABI-V007
Missing package file
Fix
Add the missing file; `module pack` lists exactly what is required.
HANABI-V008
Secret file in package
Fix
Remove .env / key / token files from the package; keep secrets out of modules.
HANABI-V009
Blocked file type
Fix
Remove the blocked file; ship source, not binaries.
HANABI-V010
Package is not a .zip
Fix
Produce the package with `hanabi module pack` and upload the resulting .zip.
HANABI-V011
Invalid window size
Fix
Set a min size and a default size at least as large as the minimum.
HANABI-V012
Invalid argument
Fix
Pass the argument the SDK method documents (the message names the field).
Quota
HANABI-Q…
· 9
Storage, capacity, and sessions.
HANABI-Q001
Storage full
Fix
Free space or ask an admin to raise the user's storage limit.
HANABI-Q002
Too many collections
Fix
Reuse existing collections, or ask an admin to raise the data.store quota.
HANABI-Q003
Too many records
Fix
Delete old records, or ask an admin to raise the data.store quota.
HANABI-Q004
Data store too large
Fix
Store less per document, or ask an admin to raise the data.store quota.
HANABI-Q005
Task queue full
Fix
Wait for tasks to finish, or ask an admin to raise the jobs.queue quota.
HANABI-Q006
Too many schedules
Fix
Delete an existing schedule, or ask an admin to raise the jobs.schedule quota.
HANABI-Q007
Schedule too frequent
Fix
Increase the interval to at least the min_interval_seconds quota.
HANABI-Q008
Server busy
Fix
Retry shortly; this is transient back-pressure, not a fault in your module.
HANABI-Q009
Dev sandbox session ended
Fix
Start a new dev-sandbox session to keep testing (the timer resets to 30 minutes).
Module lifecycle
HANABI-M…
· 10
Install, version, and lifecycle.
HANABI-M001
NOT_FOUND
Module not found
Fix
Check the module id; install or publish the module first.
HANABI-M002
NOT_FOUND
Module not installed
Fix
Install the module from the Module Store before using it.
HANABI-M003
Module not approved
Fix
Publish the module / have an admin approve the capability it needs.
HANABI-M004
No runnable build
Fix
Upload a valid package in the Developer Portal first.
HANABI-M005
Module assets unavailable
Fix
Re-publish the package; the stored build assets are missing.
HANABI-M006
Job not found
Fix
Check the job id returned when you created the job.
HANABI-M007
Schedule not found
Fix
List schedules to get valid ids.
HANABI-M008
Service not found
Fix
Start the service (worker.service) before addressing it.
HANABI-M009
Module draft not found
Fix
Create the draft in the Developer Portal first.
HANABI-M010
Invalid job state
Fix
Only act on jobs in the right state; refresh the job status first.
Account & sign-in
HANABI-U…
· 8
Session, identity, and roles.
HANABI-U001
UNAUTHENTICATED
Not authenticated
Fix
Sign in; the session cookie must be present.
HANABI-U002
PERMISSION_DENIED
Admin access required
Fix
Sign in as an admin (or have an admin perform the action).
HANABI-U003
PERMISSION_DENIED
CSRF check failed
Fix
Send the X-CSRF-Token header from /auth/me with state-changing requests.
HANABI-U004
Invalid or expired ticket
Fix
Request a fresh ticket via openMedia() and use it promptly.
HANABI-U005
Account not found
Fix
Check the account id.
HANABI-U006
Role not found
Fix
Check the role id.
HANABI-U007
Weak or invalid password
Fix
Use a password of at least the required length.
HANABI-U008
Username already taken
Fix
Pick a different username.