Query the firewall log
GET
The firewalls' decisions, newest first. Pass a response's nextCursor as before to read the next (older) page; an empty nextCursor means there are no more entries.
header
AuthorizationBearer <token>A personal or service access token, sent as Authorization: Bearer <token>. See access tokens.
namespace*stringThe namespace id.
firewall?stringOnly entries from this firewall.
allUsers?booleanEntries from every user, not only the caller's.
user?stringOnly entries from this user. Cannot be combined with allUsers.
phase?stringOnly entries from this request phase.
Value in
"versions""download""upload"kind?stringRule decisions or processing errors.
Value in
"rule""error"status?stringOnly entries with this outcome.
Value in
"blocked""allowed""error"limit?integerPage size.
Range
1 <= value <= 1000Default
100before?stringThe nextCursor of the previous page.
A page of log entries.
application/json- response
A page of log entries, newest first.
entries*array<>The log entries.
nextCursor*stringPass as before to read the next, older page. Empty when there are no more entries.
curl -X GET 'https://eu-sov-1.bytesafecloud.eu/v1/my-namespace-id/log'{ "entries": [ { "timestamp": "2026-03-02T09:30:00Z", "user": "user-123", "request": "c0a8e2f4-5b1d-4f7e-9a63-2d4b8e1f0c77", "interaction": "ci-build-4711", "userAgent": "npm/10.8.2 node/v22.11.0 linux x64", "firewall": "npm-main", "firewallVersion": 3, "upstream": "npmjs", "rule": "block-malware", "executionPhase": "download", "blocked": true, "ecosystem": "npm", "packageName": "event-stream", "version": "3.3.6", "published": "2026-03-01T09:30:00Z", "message": "Block packages with known malware." }, { "timestamp": "2026-03-02T09:29:00Z", "user": "user-123", "request": "7f3d9b21-0e4a-4c58-b6d2-91a7c3e5f804", "interaction": "ci-build-4711", "firewall": "npm-main", "firewallVersion": 3, "upstream": "npmjs", "rule": "", "executionPhase": "versions", "blocked": false, "ecosystem": "npm", "packageName": "left-pad", "version": "", "message": "upstream request failed: rate limited (status 429) [https://registry.npmjs.org] ×3", "upstreamError": { "endpoint": "https://registry.npmjs.org", "url": "https://registry.npmjs.org/left-pad", "status": 429, "reason": "rate limited", "count": 3 } } ], "nextCursor": "eyJ0IjoiMjAyNi0wMy0wMlQwOToyOTowMFoifQ"}