FIfiles
user_lifecycle_rules
User Lifecycle Rules

Show User Lifecycle Rule

Changed on

Show User Lifecycle Rule

get/user_lifecycle_rules/{id}

Request

  • Base URL
    https://app.files.com/api/rest/v1
  • URL
    https://app.files.com/api/rest/v1/user_lifecycle_rules/{id}
  • Auth
    none declared

Path parameters

idinteger required

User Lifecycle Rule ID.

Response

The UserLifecycleRules object.

idinteger

User Lifecycle Rule ID

authentication_method'all' | 'password' | 'sso' | 'none' | 'email_signup' | 'password_with_imported_hash' | 'password_and_ssh_key' | 'all_non_sso'

User authentication method for which the rule will apply. Use all_non_sso to target every non-SSO authentication method with one rule.

group_idsinteger[]

Array of Group IDs to which the rule applies. If empty or not set, the rule applies to all users.

action'disable' | 'delete'

Action to take on inactive users (disable or delete)

inactivity_daysinteger

Number of days of inactivity before the rule applies

include_folder_adminsboolean

If true, the rule will apply to folder admins.

include_site_adminsboolean

If true, the rule includes Site Administrators, who always belong to the Default Workspace. Can only be enabled when workspace_id is 0.

apply_to_all_workspacesboolean

If true, a Default Workspace rule also applies to users in all Custom Workspaces. Can only be enabled when workspace_id is 0.

namestring

User Lifecycle Rule name

notify_usersboolean

If true, users will be emailed before the rule disables or deletes them.

partner_tagstring

If provided, only users belonging to Partners with this tag at the Partner level will be affected by the rule. Tags must only contain lowercase letters, numbers, and hyphens.

site_idinteger

Site ID

workspace_idinteger

Workspace whose users the rule applies to. 0 means the Default Workspace. A Custom Workspace rule applies only to users who belong to that Workspace, regardless of access granted to other users.

user_state'inactive' | 'disabled'

State of the users to apply the rule to (inactive or disabled)

user_tagstring

If provided, only users with this tag will be affected by the rule. Tags must only contain lowercase letters, numbers, and hyphens.

Example response

{
  "id": 1,
  "authentication_method": "all_non_sso",
  "group_ids": [
    1,
    2,
    3
  ],
  "action": "disable",
  "inactivity_days": 12,
  "include_folder_admins": true,
  "include_site_admins": true,
  "apply_to_all_workspaces": true,
  "name": "password specific rules",
  "notify_users": true,
  "partner_tag": "guest",
  "site_id": 1,
  "user_state": "inactive",
  "user_tag": "guest"
}

Changes