- API Reference
- Box API
- Stats & logs
Turn developer logging on or off and set logger levels
Use this to raise log verbosity while debugging and to lower it afterwards. The body may be wrapped in data. Loggers without a name or level are skipped. Settings are saved and applied at once; verbose levels make logs grow quickly.
POST
/v2/dev_loggingRequest body application/json · required
settingsobjectoptional
settings.enabledbooleanoptional
loggersobject[]optional
loggers[].logger_namestringoptional
loggers[].selected_levelstringoptional
DEBUG, INFO, WARNING, ERROR (level is accepted too).
Responses
Result.
statusbooleanrequired
True when the box accepted the request.
msgstringrequired
Outcome code or message (see the operation's error table).
The caller is not trusted (not loopback, LAN, whitelisted or allowed Tailscale) and sent no valid Basic credentials. The body depends on whether "Basic auth for all API" is on. Routes that also use the panel login can answer a plain-text 401 "Unauthorized Access" instead.
Errors returned in msg
| msg | Meaning | What to do |
|---|---|---|
Failed to apply configuration | Saving or applying the levels failed. | Check logger names and levels. |
Configuration failed! | Unexpected error. | Retry; check the box logs. |