Skip to main content
POST
Block IP addresses

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
ips
string
required

IP(s) or CIDR range(s) to block — comma-separated for multiple (e.g. "203.0.113.7, 198.51.100.0/24")

Minimum string length: 1
reason
string

Why these addresses are being blocked

expires_in_hours
integer

Lift the block automatically after this many hours (max 8760). Omit for a permanent block. Automated callers should always set this: a shared or carrier-grade NAT address fronts many people, and a permanent block on one bans all of them.

Required range: x <= 8760

Response

Default Response

blocked
object[]
required

Addresses that were successfully blocked

skipped
string[]
required

Addresses that needed no action — already blocked, or not a valid IP/CIDR

failed
object[]
required

Addresses that could NOT be blocked — these are still unblocked

summary
object
required