Create an access rule
Adds an access rule to a network — either including a specific list of locations or excluding one. Rules can be scheduled: they start today unless you set a future start date, and can be given an end date after which they expire automatically. Important: adding the first rule to a network switches it from showing everything to showing only what the rules allow.
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Headers
Client-generated unique key per operation intent (UUID). Same key + identical body replays the original response; same key + different body returns 409.
Path Parameters
The unique ID of the network to add the rule to.
Body
Whether the rule includes or excludes the listed locations
EXCLUDE_LOCATIONS, INCLUDE_LOCATIONS UUIDs of locations the rule applies to
Rule precedence; lower number = higher precedence
x >= 0When the rule becomes active (ISO 8601). Must not be more than a minute in the past if set; defaults to now when omitted.
When the rule stops being active (ISO 8601). Null/omitted means open-ended.
Response
The created access rule.
Access rule identifier.
emp_identity the rule belongs to.
Owning tenant identifier.
Whether the rule includes or excludes.
EXCLUDE_LOCATIONS, INCLUDE_LOCATIONS Network the rule applies to.
Locations the rule targets; null when the rule is not location-scoped.
Evaluation priority (lower wins).
Date from which the rule is effective (UTC).
Date the rule stops being effective (UTC); null means open-ended.
Creation timestamp (UTC).
Last-update timestamp (UTC).