Vigilbase One APIServices

Create a Cloudflare zone IP intel

Country and network for IP addresses in this zone's WAF rules and traffic. Only callers who can read the zone may ask, and each user has a lookup budget. The addresses themselves aren't checked against the zone.

POST/api/services/cloudflare/zones/{zoneId}/ip-intel

Authorizations

Send one of these:

AuthorizationstringAccess tokenheaderrequired

Bearer access token from Vigilbase Identity (auth.vigilbase.com), sent as Authorization: Bearer <token>. The CLI gets one with vigilbase login.

AuthorizationstringAPI keyheaderrequired

Organisation API key (vb_one_…) from Settings → API keys in Vigilbase One, sent as Authorization: Bearer vb_one_…. Needs a key with write access: read-only keys get 403 with the code read_only_key. See organisation API keys.

Path Parameters

zoneIdstringrequired

Body

application/json

The catalog has no JSON Schema for this body. One validates it with the schema below.

Validation schema

BodySchema = z.object({
  customerId: z.string().uuid(),
  ips: z.array(z.string().min(2).max(45)).min(1).max(MAX_IPS_PER_REQUEST),
})

Response

Success

# Token from `vigilbase login`, or a write API key (vb_one_…)
curl --request POST \
  --url 'https://one.vigilbase.com/api/services/cloudflare/zones/{zoneId}/ip-intel' \
  --header "Authorization: Bearer $VIGILBASE_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{}'

Set VIGILBASE_TOKEN to an Identity access token or an organisation API key first, or use Try it.

Responses

200Success

401Authentication required

403Not permitted

The catalog doesn't include example response bodies for this endpoint.

Was this page helpful?