Proteside Docs
Endpoint referenceRules

Create a rule

POST
/rules

Authorization

bearerAuth
headerAuthorizationBearer <token>

API token created in Settings → API. Scopes are attached to the token; each operation lists its required scope in x-scope.

Query Parameters

org_id?string

Partners only (orgs:manage): act on this child organization. May also be sent as org_id in JSON bodies.

Formatuuid

Header Parameters

Idempotency-Key?string

Replays the original response for 24 h

Length1 <= length <= 255

Request Body

application/json
  1. body
store_id*string
Formatuuid
type*string
Value in"block""allow"
target*string
Value in"domain""src""hash"
value*string
Lengthlength <= 512
label?|
Lengthlength <= 120

Response Body

Rule

application/json
  1. response
id?string
Formatuuid
store_id?string
Formatuuid
type?string
Value in"block""allow"
target?string
Value in"domain""src""hash"
value?string
label?string|null
active?boolean
created_at?string
Formatdate-time
curl -X POST "https://example.com/rules" \  -H "Content-Type: application/json" \  -d '{    "store_id": "0c1d2e3f-1111-4222-8333-444455556666",    "type": "block",    "target": "domain",    "value": "evil-cdn.example",    "label": "Known skimmer host"  }'
{  "id": "c9d8e7f6-6666-4777-8888-999900001111",  "store_id": "0c1d2e3f-1111-4222-8333-444455556666",  "type": "block",  "target": "domain",  "value": "evil-cdn.example",  "label": "Known skimmer host",  "active": true,  "created_at": "2026-09-27T10:10:00.000Z"}