Skip to content

Get details of an auth function rule

GET
/api/v2/organizations/{organization}/projects/{project}/rules/auth-function/{rule}
curl --request GET \
--url https://dashboard.quantcdn.io/api/v2/organizations/example/projects/example/rules/auth-function/example \
--header 'Authorization: Bearer <token>'
organization
required
string

Organization identifier

project
required
string

Project identifier

rule
required
string

Rule identifier

The request has succeeded.

Media typeapplication/json
object
name

Rule name

string
uuid
required

Rule UUID

string
rule_id

Rule ID

string
weight

Rule order. Must be 0 or greater; lower weights are processed first. If omitted on create, the rule is placed last.

integer
url

URL patterns

Array<string>
domain

Exact hostnames the rule matches, or ‘any’. Wildcards are not supported.

Array<string>
disabled
required

Whether rule is disabled

boolean
only_with_cookie

Only apply with cookie

string
method

HTTP method

string
method_is

Allowed HTTP methods

Array<string>
method_is_not

Excluded HTTP methods

Array<string>
ip

IP address

string
ip_is

Allowed IP addresses

Array<string>
ip_is_not

Excluded IP addresses

Array<string>
asn

ASN condition type (asn_is, asn_is_not, any)

string
asn_is

Allowed AS numbers

Array<string>
asn_is_not

Excluded AS numbers

Array<string>
ua

User agent condition type (ua_is, ua_is_not, any)

string
ua_is

User agent strings to match

Array<string>
ua_is_not

User agent strings to exclude

Array<string>
traffic_source

Traffic source condition type (traffic_source_is, traffic_source_is_not, any)

string
traffic_source_is

Traffic sources to match (cloud, vpn, tor-exit, abuser, crawler)

Array<string>
traffic_source_is_not

Traffic sources to exclude (cloud, vpn, tor-exit, abuser, crawler)

Array<string>
country

Country code

string
country_is

Allowed countries

Array<string>
country_is_not

Excluded countries

Array<string>
action
required

Rule action

string
action_config
required
object
fn_uuid
required

UUID of the auth function (type edge_auth) the rule runs

string
Example
{
"name": "Test redirect rule",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"rule_id": "rule-001",
"weight": 100,
"url": [
"/old-path/*",
"/legacy/*"
],
"domain": [
"test-domain.com",
"www.test-domain.com"
],
"disabled": false,
"only_with_cookie": "session_id",
"method": "GET",
"method_is": [
"GET",
"POST"
],
"method_is_not": [
"DELETE",
"PUT"
],
"ip": "192.168.1.1",
"ip_is": [
"192.168.1.0/24",
"10.0.0.1"
],
"ip_is_not": [
"172.16.0.0/12"
],
"asn": "any",
"asn_is": [
"15169",
"8075"
],
"asn_is_not": [
"13335"
],
"ua": "any",
"ua_is": [
"Googlebot"
],
"ua_is_not": [
"curl"
],
"traffic_source": "any",
"traffic_source_is": [
"tor-exit"
],
"traffic_source_is_not": [
"crawler"
],
"country": "US",
"country_is": [
"US",
"CA",
"GB"
],
"country_is_not": [
"CN",
"RU"
],
"action": "redirect",
"action_config": {
"fn_uuid": "9a7b5c3d-1e2f-4a6b-8c9d-0e1f2a3b4c5d"
}
}

The server could not understand the request due to invalid syntax.

Media typeapplication/json
object
message
required

Error message

string
error
required

Error flag

boolean
Example
{
"message": "The requested resource was not found",
"error": true
}

Access is forbidden.

Media typeapplication/json
object
message
required

Error message

string
error
required

Error flag

boolean
Example
{
"message": "The requested resource was not found",
"error": true
}