List firewalls

GET
/v1/{namespace}/config

Authorization

headerAuthorizationBearer <token>

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

Path Parameters

namespace*string

The namespace id.

Response Body

The namespace's firewalls the caller can read.

application/json
  1. response
[index: integer]?

A firewall: the upstream registries it proxies for one package ecosystem, and the rules and exceptions it enforces on them.

curl -X GET 'https://eu-sov-1.bytesafecloud.eu/v1/my-namespace-id/config'
[  {    "id": "npm-main",    "version": 3,    "ecosystem": "npm",    "upstreams": [      {        "id": "internal",        "endpoint": "https://npm.internal.example.com",        "credentials": {          "username": "1F56ED4E-D401-49E4-B40C-0B7B8411BAD6",          "password": "1F56ED4E-D401-49E4-B40C-0B7B8411BAD6"        },        "internal": true,        "cached": true,        "artifactCredentials": [          {            "host": "files.internal.example.com",            "credentials": {              "token": "1F56ED4E-D401-49E4-B40C-0B7B8411BAD6"            }          }        ]      },      {        "id": "npmjs",        "endpoint": "https://registry.npmjs.org",        "credentials": {          "token": "1F56ED4E-D401-49E4-B40C-0B7B8411BAD6"        },        "internal": false,        "cached": false      }    ],    "rules": [      {        "id": "block-malware",        "executionPhase": "download",        "selector": {          "function": {            "name": "malware"          }        },        "ruleEffect": {          "block": true,          "log": true        },        "description": "Block packages with known malware."      }    ],    "exceptions": [],    "name": "npm (main)",    "description": "The npm firewall used by every build.",    "updatedAt": "2026-03-02T09:30:00Z",    "permissions": {      "3b6f1e2a-9c4d-4e7f-a815-6d2c0b9e7f41": [        "fw:access",        "fw:clone",        "fw:read",        "fw:update:config",        "fw:update:credentials",        "fw:update:rule",        "fw:update:exception",        "fw:delete"      ],      "everybody": [        "fw:access",        "fw:clone",        "fw:read"      ]    }  }]