companies

Previews which active agent instances a CIDR allowlist would block.

Requires the privilege COMPANY_SECURITY_WRITE

post/companies/{identifier}/auth/cidr-blocks/validate

Path parameters

identifierstring required

cidrBlocksstring[] required

IPv4 or IPv6 CIDR blocks to test.

default response

totalInstancesinteger

Total active application instances (seen within last 5 minutes).

blockedInstancesinteger

Instances that would be blocked by the supplied CIDR list.

blockedPercentnumber double

Percentage of active instances that would be blocked.

instancesWithUnknownXffinteger

Instances whose last-seen IP is unknown (registered before XFF capture was added); excluded from blocked count.

callerIpstring

Source IP of the API caller (from X-Forwarded-For); null if not detectable.

callerBlockedboolean

Whether the caller's own IP would be blocked by the supplied CIDR list.

No recorded changes to this endpoint across all 10 revisions of this API.