See api-docs Menu

List Rules

Use this API to return a list of rules that been defined for an application. A powerful set of filters can be used to return mappings that contain specific conditions or actions.

By default this endpoint only returns the rules that are currently enabled. To return disabled rules set the enabled query parameter to false.

Pagination is not supported on this endpoint.





Resource URL

https://<api-domain>/api/2/apps/:app_id/rules

Header Parameters

Authorization

required

string

Set to bearer <access_token>.

Set <access_token> to the access token you generated using the Generate Token API.

The access token must have been generated using an API credential pair created using the scope required to call this API. This API can be called using any one of the following scopes: Manage All.

Resource Parameters

app_id

required

integer

The id of the application that where the rules apply.

Query Parameters

enabled

boolean

Defaults to true. When set to `false` will return all disabled rules.

has_condition

string

Filters Rules based on their Conditions. Values formatted as :, where name is the Condition to look for, and value is the value to find. Multiple filters can be declared by using a comma delimited list. Wildcards are supported in both the name and value fields.

For example:

Single filter. has_condition=has_role:123456

Multiple filters. has_condition=has_role:123456,status:1

Wildcard for conditions. has_condition=*:123456

Wildcard for condition values. has_condition=has_role:*

has_condition_type

string

Filters Rules based on their condition types.

Allowed values are:

  • builtin - actions that involve standard attributes
  • custom - actions that involve custom attributes
  • none - no actions are defined

For example:

Find Rules using custom user attributes has_condition_type=custom

Find Rules with no conditions has_condition_type=none

has_action

string

Filters Rules based on their Actions. Values formatted as :, where name is the Action to look for, and value is the value to find. Multiple filters can be declared by using a comma delimited list. Wildcards are supported in both the name and value fields.

For example:

Single filter. has_action=set_licenses:123456

Multiple filters. has_action=set_groups:123456,set_usertype:*

Wildcard for actions. has_action=*:123456

Wildcard for action values. has_action=set_userprincipalname:*

has_action_type

string

Filters Rules based on their action types.

Allowed values are:

  • builtin - actions that involve standard attributes
  • custom - actions that involve custom attributes
  • none - no actions are defined

For example:

Find Rules with no actions has_action_type=none

Sample Responses

[
  {
      "id": 196673,
      "name": "My first rule",
      "match": "all",
      "enabled": true,
      "position": 1,
      "conditions": [
          {
              "source": "last_login",
              "operator": ">",
              "value": "90"
          }
      ],
      "actions": [
          {
              "action": "set_status",
              "value": ["2"]
          }
      ]
  }
  ...
]

Typically, this error means that your access token value is invalid.

{
    "message": "Unauthorized",
    "statusCode": 401,
    "name": "UnauthorizedError"
}

Postman Collection

Replace sample variables indicated by {{ }} with your actual values.

Download for the Apps Rules API

Sample Code

cURL

Replace sample values indicated by < > with your actual values.

List Rules

curl 'https://<api-domain>/api/2/apps/:app_id/rules' \
-X GET \
-H "Authorization: bearer <access_token>"

Have a Question?

Found a bug? Submit a support ticket.

Have a product idea or request? Share it with us in our Ideas Portal.