[DOC] Improve Idle Account Suspension API to return disabled and non-disabled users

[KaveeshaPiumini]

Purpose

This PR adds the documentation for the enhancement done with an optional new query parameter, filter in the getInactiveUsers API to:

• Filtering disabled users from all inactive users for a given time period.
• Filtering non-disabled users from all inactive users for a given time period.

Example

Sample Request
https://localhost:9443/api/idle-account-identification/v1/inactive-users?inactiveAfter=2024-12-21&excludeBefore=2024-12-11&filter=isDisabled eq false

Sample Response

[
    {
        "userId": "a0b6793e-d996-4bc8-b600-ff8d3ce5fc9a",
        "username": "kim",
        "userStoreDomain": "PRIMARY"
    },
    {
        "userId": "c7d21584-483e-4177-a5e5-a7da6f3edef7",
        "username": "kimthree",
        "userStoreDomain": "PRIMARY"
    }
] 

Related Issue

• Improve Idle Account Suspension API to return disabled and non-disabled users product-is#21907