Get a rule

Retrieve rule details. Accepts a list of fields to include or exclude in the result.

GET https://{tenantDomain}/api/v2/rules/{id}

C#

C#

using Auth0.ManagementApi;
using System.Threading.Tasks;

public partial class Examples
{
    public async Task Example() {
        var client = new ManagementClient(
            token: "<token>"
        );

        await client.Rules.GetAsync(
            id: "id",
            request: new GetRuleRequestParameters {
                Fields = "fields",
                IncludeFields = true
            }
        );
    }

}

200

{
  "name": "rule_1",
  "id": "con_0000000000000001",
  "enabled": true,
  "script": "function (user, context, callback) {\n  callback(null, user, context);\n}",
  "order": 1,
  "stage": "login_success"
}

Authorizations

bearerAuthoAuth2ClientCredentials

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id · string · required

ID of the rule to retrieve.

Query Parameters

fields · string

Comma-separated list of fields to include or exclude (based on value provided for include_fields) in the result. Leave empty to retrieve all fields.

include_fields · boolean

Whether specified fields are to be included (true) or excluded (false).

Response

200

application/json

Rule successfully retrieved.

name · string · default: rule_1

Name of this rule.

id · string · default: con_0000000000000001

ID of this rule.

enabled · boolean · default: true

Whether the rule is enabled (true), or disabled (false).

script · string · default: function (user, context, callback) { callback(null, user, context); }

Code to be executed when this rule runs.

order · number · default: 1

Order that this rule should execute in relative to other rules. Lower-valued rules execute first.

stage · string · default: login_success

Execution stage of this rule. Can be login_success, login_failure, or pre_authorize.