Get an exception request

GET
/v1/{namespace}/config/{firewall}/exception-requests/{id}

Authorization

headerAuthorizationBearer <token>

A personal or service access token, sent as Authorization: Bearer <token>. See access tokens.

Path Parameters

namespace*string

The namespace id.

firewall*string

The firewall id.

id*string

The exception request id.

Response Body

The request.

application/json
  1. response

An exception request, with what the caller may do with it.

id*string

The request id.

firewallId*string

The firewall the exception is requested on.

status*string

pending until decided; then approved, denied or withdrawn. A denied request can still be approved.

Value in"pending""approved""denied""withdrawn"
proposedException*

The exception the requester asks for. The approver may change it; the exception actually added is referenced by exceptionId.

justification*string

Why the requester needs the exception.

requestedBy*string

The user id of the requester.

requestedAt*string

When the request was made.

Formatdate-time
decidedBy?string

The user id of whoever approved, denied or withdrew the request.

decidedAt?string

When the request was approved, denied or withdrawn.

Formatdate-time
decisionComment?string

The comment given with the decision. Always present on denied requests.

exceptionId?string

The id of the exception added when the request was approved.

updatedAt*string

When the request last changed.

Formatdate-time
firewallName?string

The name of the request's firewall.

ruleDescription?string

The description of the rule the exception is for. Absent when the rule has no description or no longer exists.

canApprove*boolean

Whether the caller may approve the request.

canDeny*boolean

Whether the caller may deny the request.

canWithdraw*boolean

Whether the caller may withdraw the request.

curl -X GET 'https://eu-sov-1.bytesafecloud.eu/v1/my-namespace-id/config/my-firewall-id/exception-requests/exr-01JZ8Q2V6R9X3T5W7Y0A2C4E6G'
{  "id": "exr-01JZ8Q2V6R9X3T5W7Y0A2C4E6G",  "firewallId": "npm-main",  "status": "pending",  "proposedException": {    "id": "allow-left-pad",    "rule": "block-malware",    "selector": {      "packageName": "left-pad",      "version": "1.3.0"    },    "log": true,    "expires": "2026-05-31T09:30:00Z",    "reason": "evaluating_component"  },  "justification": "Needed for the build until we migrate off left-pad.",  "requestedBy": "user_2a9f",  "requestedAt": "2026-03-02T09:30:00Z",  "updatedAt": "2026-03-02T09:30:00Z",  "firewallName": "npm main",  "ruleDescription": "Block known malware",  "canApprove": true,  "canDeny": true,  "canWithdraw": true}