Update Rule
Use this API to update an existing App Rule.
Resource URL
https://<api-domain>/api/2/apps/:app_id/rules/:id
Header Parameters
Authorization required string | Set to Set 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: |
Content-Type required string |
Set to application/json . |
Resource Parameter
app_id required integer | The id of the application that where the rules apply. |
id required integer |
Set to the |
Request Parameters
name
required |
The name of the rule. | String |
enabled
required |
Indicates if the rule is enabled or not. | Boolean |
match
required |
Indicates how conditions should be matched.
|
String |
position
required |
Indicates the order of the rule. When `null` this will default to last position. | Integer |
conditions
required |
An array of conditions that the user must meet in order for the mapping to be applied.
|
Array |
actions
required |
An array of actions that will be applied to the users that are matched by the conditions.
|
Array |
Sample Request Body
{
"name": "Suspend users after 120 days inactive",
"match": "all",
"enabled": true,
"position": 1,
"conditions": [
{
"source": "last_login",
"operator": ">",
"value": "120"
}
],
"actions": [
{
"action": "set_status",
"value": "2"
}
]
}
Sample Responses
- 200 OK
- 401 Unauthorized
- 422 Unprocessable Entity
{
"id": 1022697
}
Typically, this error means that your access token value is invalid.
{
"message": "Unauthorized",
"statusCode": 401,
"name": "UnauthorizedError"
}
ID should not be included in the payload body.
{
"code": 422,
"message": "Validation Failed",
"errors": [
{
"field": "id",
"message": [
"Field is not allowed"
]
}
]
}
Response Elements
id |
Unique ID for app rule in OneLogin. |
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.
Update a Rule
curl 'https://<api-domain>/api/2/apps/:app_id/rules/:id' \
-X PUT \
-H "Authorization: bearer <access_token>"
-H "Content-Type: application/json" \
-d '{
"name": "Suspend users after 120 days inactive",
"match": "all",
"enabled": true,
"position": 1,
"conditions": [
{
"source": "last_login",
"operator": ">",
"value": "120"
}
],
"actions": [
{
"action": "set_status",
"value": ["2"]
}
]
}'
Have a Question?

Found a bug? Submit a support ticket.

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