List of Users

curl --request GET \
  --url https://wksusa1b2c3d.provisionr.app/api/v1/directory/users \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://wksusa1b2c3d.provisionr.app/api/v1/directory/users', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

[
  {
    "id": "drusr_01hq8xyzabc123def456ghi789",
    "state": "active",
    "manager_id": "drusr_01kam9z5z71f7r4hhrm2ydxkhn",
    "is_manager": true,
    "first_name": "Dade",
    "last_name": "Murphy",
    "full_name": "Dade Murphy",
    "email": "[email protected]",
    "username": "dmurphy",
    "badge_id": "<string>",
    "employee_id": "<string>",
    "employee_alt_id": "<string>",
    "timestamp": {
      "created_at": "2025-01-28T13:37:00Z",
      "updated_at": "2025-05-04T03:27:00Z",
      "deleted_at": null,
      "expires_at": null,
      "provisioned_at": "2025-03-14T15:07:00Z",
      "deprovisioned_at": null
    },
    "org": {
      "cost_center": "CC-1234",
      "department": "Infrastructure",
      "division": "Engineering",
      "title": "Senior Engineer"
    },
    "metadata": {
      "custom_field_1": "value1",
      "employee_type": "full-time",
      "desk_number": "42"
    },
    "count": {
      "secondary_users": 123,
      "direct_report_users": 123,
      "directory_identities": 123,
      "policy_conditions": 123,
      "policy_users": 123,
      "policy_rulesets": 123,
      "manifest_rules": 123,
      "qualified_rules": 123,
      "staged_rules": 123,
      "audit_logs_parent": 123,
      "audit_logs_record": 123,
      "audit_logs_related": 123,
      "audit_logs_subject": 123,
      "directory_attributes": 123,
      "gitlab_groups": 123,
      "gitlab_projects": 123,
      "google_drive_docs": 123,
      "google_drive_files": 123,
      "google_drive_folders": 123,
      "google_drive_decks": 123,
      "google_drive_sheets": 123,
      "google_identity_groups": 123,
      "google_workspace_drives": 123,
      "google_workspace_groups": 123,
      "okta_groups": 123,
      "slack_public_channels": 123,
      "slack_private_channels": 123,
      "slack_groups": 123
    },
    "included": {
      "user_manager": {
        "id": "drusr_01hq8xyzabc123def456ghi789",
        "state": "active",
        "manager_id": "drusr_01kam9z5z71f7r4hhrm2ydxkhn",
        "is_manager": true,
        "full_name": "Dade Murphy",
        "email": "[email protected]",
        "username": "dmurphy",
        "badge_id": "<string>",
        "employee_id": "<string>",
        "employee_alt_id": "<string>",
        "org": {
          "cost_center": "CC-1234",
          "department": "Infrastructure",
          "division": "Engineering",
          "title": "Senior Engineer"
        },
        "metadata": {
          "custom_field_1": "value1",
          "employee_type": "full-time",
          "desk_number": "42"
        }
      },
      "workspace_user": {
        "id": "wsusr_01hq8xyzabc123def456ghi789",
        "state": "staged",
        "provider": "hq",
        "provider_id": "<string>",
        "name": "<string>",
        "handle": "<string>",
        "email": "<string>"
      },
      "parent_user": {
        "id": "drusr_01hq8xyzabc123def456ghi789",
        "state": "active",
        "manager_id": "drusr_01kam9z5z71f7r4hhrm2ydxkhn",
        "is_manager": true,
        "full_name": "Dade Murphy",
        "email": "[email protected]",
        "username": "dmurphy",
        "badge_id": "<string>",
        "employee_id": "<string>",
        "employee_alt_id": "<string>",
        "org": {
          "cost_center": "CC-1234",
          "department": "Infrastructure",
          "division": "Engineering",
          "title": "Senior Engineer"
        },
        "metadata": {
          "custom_field_1": "value1",
          "employee_type": "full-time",
          "desk_number": "42"
        }
      },
      "secondary_users": [
        {
          "id": "drusr_01hq8xyzabc123def456ghi789",
          "state": "active",
          "manager_id": "drusr_01kam9z5z71f7r4hhrm2ydxkhn",
          "is_manager": true,
          "full_name": "Dade Murphy",
          "email": "[email protected]",
          "username": "dmurphy",
          "badge_id": "<string>",
          "employee_id": "<string>",
          "employee_alt_id": "<string>",
          "org": {
            "cost_center": "CC-1234",
            "department": "Infrastructure",
            "division": "Engineering",
            "title": "Senior Engineer"
          },
          "metadata": {
            "custom_field_1": "value1",
            "employee_type": "full-time",
            "desk_number": "42"
          }
        }
      ],
      "direct_report_users": [
        {
          "id": "drusr_01hq8xyzabc123def456ghi789",
          "state": "active",
          "manager_id": "drusr_01kam9z5z71f7r4hhrm2ydxkhn",
          "is_manager": true,
          "full_name": "Dade Murphy",
          "email": "[email protected]",
          "username": "dmurphy",
          "badge_id": "<string>",
          "employee_id": "<string>",
          "employee_alt_id": "<string>",
          "org": {
            "cost_center": "CC-1234",
            "department": "Infrastructure",
            "division": "Engineering",
            "title": "Senior Engineer"
          },
          "metadata": {
            "custom_field_1": "value1",
            "employee_type": "full-time",
            "desk_number": "42"
          }
        }
      ],
      "integration": {
        "id": "gitg_01hq8xyzabc123def456ghi789",
        "vendor": "google",
        "is_primary": true
      },
      "directory_identities": [
        {
          "id": "dridt_01hq8xyzabc123def456ghi789",
          "integration_id": "<string>",
          "integration_type": "<string>",
          "directory_user_id": "drusr_01hq8xyzabc123def456ghi789",
          "integration_vendor": "okta",
          "integration_handle": "okta-prod",
          "vendor_id": "<string>",
          "full_name": "<string>",
          "email": "<string>",
          "org": {},
          "state": "staged"
        }
      ],
      "policy_conditions": [
        {
          "id": "pocon_01hq8xyzabc123def456ghi789",
          "is_imported": true,
          "type": "attribute",
          "ruleset_id": "poset_01hq8xyzabc123def456ghi789",
          "rule_id": "porul_01hq8xyzabc123def456ghi789",
          "resource_id": "dratr_01hq8xyzabc123def456ghi789",
          "profile_key": "department",
          "profile_operator": "equals",
          "profile_value": "IT Helpdesk",
          "description": "<string>"
        }
      ],
      "policy_users": [
        {
          "id": "pousr_01hq8xyzabc123def456ghi789",
          "state": "staged",
          "timestamp": {
            "created_at": "2025-01-28T13:37:00Z",
            "updated_at": "2025-05-04T03:27:00Z",
            "activated_at": "2025-03-14T15:07:00Z",
            "expires_at": null,
            "deleted_at": null
          },
          "included": {
            "directory_user": {
              "id": "drusr_01hq8xyzabc123def456ghi789",
              "state": "active",
              "manager_id": "drusr_01kam9z5z71f7r4hhrm2ydxkhn",
              "is_manager": true,
              "full_name": "Dade Murphy",
              "email": "[email protected]",
              "username": "dmurphy",
              "badge_id": "<string>",
              "employee_id": "<string>",
              "employee_alt_id": "<string>",
              "org": {
                "cost_center": "CC-1234",
                "department": "Infrastructure",
                "division": "Engineering",
                "title": "Senior Engineer"
              },
              "metadata": {
                "custom_field_1": "value1",
                "employee_type": "full-time",
                "desk_number": "42"
              }
            },
            "policy_ruleset": {
              "id": "poset_01hq8xyzabc123def456ghi789",
              "state": "unmanaged",
              "type": "directory_attribute",
              "resource_id": "dratr_01hq8xyzabc123def456ghi789",
              "is_authoritative": false,
              "expires_after_days": 30
            },
            "policy_rule": {
              "id": "porul_01hq8xyzabc123def456ghi789",
              "state": "active",
              "role_name": "Group Member",
              "role_handle": "member",
              "is_imported": true,
              "description": "<string>",
              "expires_after_days": 123,
              "expires_after_days_inherited": true,
              "priority": 42
            },
            "policy_resource": {
              "id": "dratr_01hq8xyzabc123def456ghi789",
              "state": "active",
              "parent": "Department",
              "name": "Engineering",
              "handle": "eng",
              "blueprint_signature": "{blueprint_id_last4}-{dimension_id}-{attribute_id}-{ref_id}",
              "profile_value": "Engineering"
            }
          }
        }
      ],
      "policy_rules_manifest": [
        {
          "id": "porul_01hq8xyzabc123def456ghi789",
          "state": "active",
          "role_name": "Group Member",
          "role_handle": "member",
          "is_imported": true,
          "description": "<string>",
          "expires_after_days": 123,
          "expires_after_days_inherited": true,
          "priority": 42
        }
      ],
      "policy_rules_qualified": [
        {
          "id": "porul_01hq8xyzabc123def456ghi789",
          "state": "active",
          "role_name": "Group Member",
          "role_handle": "member",
          "is_imported": true,
          "description": "<string>",
          "expires_after_days": 123,
          "expires_after_days_inherited": true,
          "priority": 42
        }
      ],
      "policy_rules_staged": [
        {
          "id": "porul_01hq8xyzabc123def456ghi789",
          "state": "active",
          "role_name": "Group Member",
          "role_handle": "member",
          "is_imported": true,
          "description": "<string>",
          "expires_after_days": 123,
          "expires_after_days_inherited": true,
          "priority": 42
        }
      ],
      "policy_rulesets": [
        {
          "id": "poset_01hq8xyzabc123def456ghi789",
          "state": "unmanaged",
          "type": "directory_attribute",
          "resource_id": "dratr_01hq8xyzabc123def456ghi789",
          "is_authoritative": false,
          "expires_after_days": 30
        }
      ]
    },
    "links": {
      "self": "<string>",
      "workspace_user": "<string>",
      "integration": "<string>",
      "secondary_users": "<string>",
      "direct_report_users": "<string>",
      "directory_identities": "<string>",
      "audit_logs_parent": "<string>",
      "audit_logs_record": "<string>",
      "audit_logs_related": "<string>",
      "audit_logs_subject": "<string>"
    }
  }
]

{
  "message": "<string>"
}

{
  "message": "<string>"
}

GET

directory

users

List of Users

curl --request GET \
  --url https://wksusa1b2c3d.provisionr.app/api/v1/directory/users \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://wksusa1b2c3d.provisionr.app/api/v1/directory/users', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

[
  {
    "id": "drusr_01hq8xyzabc123def456ghi789",
    "state": "active",
    "manager_id": "drusr_01kam9z5z71f7r4hhrm2ydxkhn",
    "is_manager": true,
    "first_name": "Dade",
    "last_name": "Murphy",
    "full_name": "Dade Murphy",
    "email": "[email protected]",
    "username": "dmurphy",
    "badge_id": "<string>",
    "employee_id": "<string>",
    "employee_alt_id": "<string>",
    "timestamp": {
      "created_at": "2025-01-28T13:37:00Z",
      "updated_at": "2025-05-04T03:27:00Z",
      "deleted_at": null,
      "expires_at": null,
      "provisioned_at": "2025-03-14T15:07:00Z",
      "deprovisioned_at": null
    },
    "org": {
      "cost_center": "CC-1234",
      "department": "Infrastructure",
      "division": "Engineering",
      "title": "Senior Engineer"
    },
    "metadata": {
      "custom_field_1": "value1",
      "employee_type": "full-time",
      "desk_number": "42"
    },
    "count": {
      "secondary_users": 123,
      "direct_report_users": 123,
      "directory_identities": 123,
      "policy_conditions": 123,
      "policy_users": 123,
      "policy_rulesets": 123,
      "manifest_rules": 123,
      "qualified_rules": 123,
      "staged_rules": 123,
      "audit_logs_parent": 123,
      "audit_logs_record": 123,
      "audit_logs_related": 123,
      "audit_logs_subject": 123,
      "directory_attributes": 123,
      "gitlab_groups": 123,
      "gitlab_projects": 123,
      "google_drive_docs": 123,
      "google_drive_files": 123,
      "google_drive_folders": 123,
      "google_drive_decks": 123,
      "google_drive_sheets": 123,
      "google_identity_groups": 123,
      "google_workspace_drives": 123,
      "google_workspace_groups": 123,
      "okta_groups": 123,
      "slack_public_channels": 123,
      "slack_private_channels": 123,
      "slack_groups": 123
    },
    "included": {
      "user_manager": {
        "id": "drusr_01hq8xyzabc123def456ghi789",
        "state": "active",
        "manager_id": "drusr_01kam9z5z71f7r4hhrm2ydxkhn",
        "is_manager": true,
        "full_name": "Dade Murphy",
        "email": "[email protected]",
        "username": "dmurphy",
        "badge_id": "<string>",
        "employee_id": "<string>",
        "employee_alt_id": "<string>",
        "org": {
          "cost_center": "CC-1234",
          "department": "Infrastructure",
          "division": "Engineering",
          "title": "Senior Engineer"
        },
        "metadata": {
          "custom_field_1": "value1",
          "employee_type": "full-time",
          "desk_number": "42"
        }
      },
      "workspace_user": {
        "id": "wsusr_01hq8xyzabc123def456ghi789",
        "state": "staged",
        "provider": "hq",
        "provider_id": "<string>",
        "name": "<string>",
        "handle": "<string>",
        "email": "<string>"
      },
      "parent_user": {
        "id": "drusr_01hq8xyzabc123def456ghi789",
        "state": "active",
        "manager_id": "drusr_01kam9z5z71f7r4hhrm2ydxkhn",
        "is_manager": true,
        "full_name": "Dade Murphy",
        "email": "[email protected]",
        "username": "dmurphy",
        "badge_id": "<string>",
        "employee_id": "<string>",
        "employee_alt_id": "<string>",
        "org": {
          "cost_center": "CC-1234",
          "department": "Infrastructure",
          "division": "Engineering",
          "title": "Senior Engineer"
        },
        "metadata": {
          "custom_field_1": "value1",
          "employee_type": "full-time",
          "desk_number": "42"
        }
      },
      "secondary_users": [
        {
          "id": "drusr_01hq8xyzabc123def456ghi789",
          "state": "active",
          "manager_id": "drusr_01kam9z5z71f7r4hhrm2ydxkhn",
          "is_manager": true,
          "full_name": "Dade Murphy",
          "email": "[email protected]",
          "username": "dmurphy",
          "badge_id": "<string>",
          "employee_id": "<string>",
          "employee_alt_id": "<string>",
          "org": {
            "cost_center": "CC-1234",
            "department": "Infrastructure",
            "division": "Engineering",
            "title": "Senior Engineer"
          },
          "metadata": {
            "custom_field_1": "value1",
            "employee_type": "full-time",
            "desk_number": "42"
          }
        }
      ],
      "direct_report_users": [
        {
          "id": "drusr_01hq8xyzabc123def456ghi789",
          "state": "active",
          "manager_id": "drusr_01kam9z5z71f7r4hhrm2ydxkhn",
          "is_manager": true,
          "full_name": "Dade Murphy",
          "email": "[email protected]",
          "username": "dmurphy",
          "badge_id": "<string>",
          "employee_id": "<string>",
          "employee_alt_id": "<string>",
          "org": {
            "cost_center": "CC-1234",
            "department": "Infrastructure",
            "division": "Engineering",
            "title": "Senior Engineer"
          },
          "metadata": {
            "custom_field_1": "value1",
            "employee_type": "full-time",
            "desk_number": "42"
          }
        }
      ],
      "integration": {
        "id": "gitg_01hq8xyzabc123def456ghi789",
        "vendor": "google",
        "is_primary": true
      },
      "directory_identities": [
        {
          "id": "dridt_01hq8xyzabc123def456ghi789",
          "integration_id": "<string>",
          "integration_type": "<string>",
          "directory_user_id": "drusr_01hq8xyzabc123def456ghi789",
          "integration_vendor": "okta",
          "integration_handle": "okta-prod",
          "vendor_id": "<string>",
          "full_name": "<string>",
          "email": "<string>",
          "org": {},
          "state": "staged"
        }
      ],
      "policy_conditions": [
        {
          "id": "pocon_01hq8xyzabc123def456ghi789",
          "is_imported": true,
          "type": "attribute",
          "ruleset_id": "poset_01hq8xyzabc123def456ghi789",
          "rule_id": "porul_01hq8xyzabc123def456ghi789",
          "resource_id": "dratr_01hq8xyzabc123def456ghi789",
          "profile_key": "department",
          "profile_operator": "equals",
          "profile_value": "IT Helpdesk",
          "description": "<string>"
        }
      ],
      "policy_users": [
        {
          "id": "pousr_01hq8xyzabc123def456ghi789",
          "state": "staged",
          "timestamp": {
            "created_at": "2025-01-28T13:37:00Z",
            "updated_at": "2025-05-04T03:27:00Z",
            "activated_at": "2025-03-14T15:07:00Z",
            "expires_at": null,
            "deleted_at": null
          },
          "included": {
            "directory_user": {
              "id": "drusr_01hq8xyzabc123def456ghi789",
              "state": "active",
              "manager_id": "drusr_01kam9z5z71f7r4hhrm2ydxkhn",
              "is_manager": true,
              "full_name": "Dade Murphy",
              "email": "[email protected]",
              "username": "dmurphy",
              "badge_id": "<string>",
              "employee_id": "<string>",
              "employee_alt_id": "<string>",
              "org": {
                "cost_center": "CC-1234",
                "department": "Infrastructure",
                "division": "Engineering",
                "title": "Senior Engineer"
              },
              "metadata": {
                "custom_field_1": "value1",
                "employee_type": "full-time",
                "desk_number": "42"
              }
            },
            "policy_ruleset": {
              "id": "poset_01hq8xyzabc123def456ghi789",
              "state": "unmanaged",
              "type": "directory_attribute",
              "resource_id": "dratr_01hq8xyzabc123def456ghi789",
              "is_authoritative": false,
              "expires_after_days": 30
            },
            "policy_rule": {
              "id": "porul_01hq8xyzabc123def456ghi789",
              "state": "active",
              "role_name": "Group Member",
              "role_handle": "member",
              "is_imported": true,
              "description": "<string>",
              "expires_after_days": 123,
              "expires_after_days_inherited": true,
              "priority": 42
            },
            "policy_resource": {
              "id": "dratr_01hq8xyzabc123def456ghi789",
              "state": "active",
              "parent": "Department",
              "name": "Engineering",
              "handle": "eng",
              "blueprint_signature": "{blueprint_id_last4}-{dimension_id}-{attribute_id}-{ref_id}",
              "profile_value": "Engineering"
            }
          }
        }
      ],
      "policy_rules_manifest": [
        {
          "id": "porul_01hq8xyzabc123def456ghi789",
          "state": "active",
          "role_name": "Group Member",
          "role_handle": "member",
          "is_imported": true,
          "description": "<string>",
          "expires_after_days": 123,
          "expires_after_days_inherited": true,
          "priority": 42
        }
      ],
      "policy_rules_qualified": [
        {
          "id": "porul_01hq8xyzabc123def456ghi789",
          "state": "active",
          "role_name": "Group Member",
          "role_handle": "member",
          "is_imported": true,
          "description": "<string>",
          "expires_after_days": 123,
          "expires_after_days_inherited": true,
          "priority": 42
        }
      ],
      "policy_rules_staged": [
        {
          "id": "porul_01hq8xyzabc123def456ghi789",
          "state": "active",
          "role_name": "Group Member",
          "role_handle": "member",
          "is_imported": true,
          "description": "<string>",
          "expires_after_days": 123,
          "expires_after_days_inherited": true,
          "priority": 42
        }
      ],
      "policy_rulesets": [
        {
          "id": "poset_01hq8xyzabc123def456ghi789",
          "state": "unmanaged",
          "type": "directory_attribute",
          "resource_id": "dratr_01hq8xyzabc123def456ghi789",
          "is_authoritative": false,
          "expires_after_days": 30
        }
      ]
    },
    "links": {
      "self": "<string>",
      "workspace_user": "<string>",
      "integration": "<string>",
      "secondary_users": "<string>",
      "direct_report_users": "<string>",
      "directory_identities": "<string>",
      "audit_logs_parent": "<string>",
      "audit_logs_record": "<string>",
      "audit_logs_related": "<string>",
      "audit_logs_subject": "<string>"
    }
  }
]

{
  "message": "<string>"
}

{
  "message": "<string>"
}

Authorizations

Authorization

string

header

required

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

Query Parameters

filter[id]

string

Filter by an exact ID match.

Example:

"drusr_01hq8xyzabc123def456ghi789"

filter[id_search]

string

Filter by a partial ID match.

Example:

"d662"

filter[integration_id]

string

Filter by the associated integration ID (polymorphic).

Example:

"wsitg_01hq8xyzabc123def456ghi789"

filter[integration_type]

string

Filter by the associated integration type (polymorphic morph class).

Example:

"App\\Models\\OktaCredential"

filter[parent_id]

string

For secondary users, you can filter by the parent user ID.

Example:

"drusr_01hq8xyzabc123def456ghi789"

filter[manager_id]

string

Filter by users that report to a specific manager user ID.

Example:

"drusr_01hq8xyzabc123def456ghi789"

filter[first_name]

string

Filter by the first (given) name of the user (exact match).

Example:

"Dade"

filter[first_name_search]

string

Filter by the first (given) name of the user (partial match).

Example:

"Dad"

filter[last_name]

string

Filter by the last (family) name of the user (exact match).

Example:

"Murphy"

filter[last_name_search]

string

Filter by the last (family) name of the user (partial match).

Example:

"Mur"

filter[full_name]

string

Filter by the full (first and last) name of the user (exact match).

Example:

"Dade Murphy"

filter[full_name_search]

string

Filter by the full (first and last) name of the user (partial match).

Example:

"Dade"

filter[email]

string

Filter by the email address of the user (exact match).

Example:

"[email protected]"

filter[email_search]

string

Filter by the email address of the user (partial match). This is useful for searching by email handle or domain name.

Example:

"dmurphy"

filter[username]

string

Filter by the username of the user (exact match).

Example:

"dade.murphy"

filter[username_search]

string

Filter by the username of the user (partial match).

Example:

"z3r0c00l"

filter[badge_id]

string

Filter by the badge ID number of the user (exact match).

Example:

"a1b2c3d4e5"

filter[badge_id_search]

string

Filter by the badge ID number of the user (partial match).

Example:

"a1b2c"

filter[employee_id]

string

Filter by the employee ID number of the user (exact match).

Example:

"a1b2c3d4e5"

filter[employee_id_search]

string

Filter by the employee ID number of the user (partial match).

Example:

"a1b2c"

filter[employee_alt_id]

string

Filter by the alternate employee ID number of the user (exact match).

Example:

"a1b2c3d4e5"

filter[employee_alt_id_search]

string

Filter by the alternate employee ID number of the user (partial match).

Example:

"a1b2c"

filter[org_array_search]

string

Search organization metadata key/value pairs for any partial string. For more granularity and specific keys, use the Policy Users endpoint for a specific Directory Dimension or Attribute.

Example:

"Engineer"

filter[metadata_array_search]

string

Search custom organization business logic metadata key/value pairs for any partial string.

filter[manager]

boolean

Filter users that are managers (have direct reports) or are not managers (individual contributors).

filter[state]

string

The state of the Directory User. See the Response Body below for more details on each state type.

Example:

"active"

filter[created_before]

string<date>

Filter results by date. Any parsable date format can be used.

Example:

"2025-01-01 or 2025-01-01 12:30:00 or 2025-01-01T12:30:00Z"

filter[created_after]

string<date>

Filter results by date. Any parsable date format can be used.

Example:

"2025-01-01 or 2025-01-01 12:30:00 or 2025-01-01T12:30:00Z"

filter[updated_before]

string<date>

Filter results by date. Any parsable date format can be used.

Example:

"2025-01-01 or 2025-01-01 12:30:00 or 2025-01-01T12:30:00Z"

filter[updated_after]

string<date>

Filter results by date. Any parsable date format can be used.

Example:

"2025-01-01 or 2025-01-01 12:30:00 or 2025-01-01T12:30:00Z"

filter[expires_before]

string<date>

Filter results by date. Any parsable date format can be used.

Example:

"2025-01-01 or 2025-01-01 12:30:00 or 2025-01-01T12:30:00Z"

filter[expires_after]

string<date>

Filter results by date. Any parsable date format can be used.

Example:

"2025-01-01 or 2025-01-01 12:30:00 or 2025-01-01T12:30:00Z"

filter[expired_before]

string<date>

Filter results by date. Any parsable date format can be used.

Example:

"2025-01-01 or 2025-01-01 12:30:00 or 2025-01-01T12:30:00Z"

filter[expired_after]

string<date>

Filter results by date. Any parsable date format can be used.

Example:

"2025-01-01 or 2025-01-01 12:30:00 or 2025-01-01T12:30:00Z"

filter[deactivated_before]

string<date>

Filter results by date. Any parsable date format can be used.

Example:

"2025-01-01 or 2025-01-01 12:30:00 or 2025-01-01T12:30:00Z"

filter[deactivated_after]

string<date>

Filter results by date. Any parsable date format can be used.

Example:

"2025-01-01 or 2025-01-01 12:30:00 or 2025-01-01T12:30:00Z"

filter[deleted_before]

string<date>

Filter results by date. Any parsable date format can be used.

Example:

"2025-01-01 or 2025-01-01 12:30:00 or 2025-01-01T12:30:00Z"

filter[deleted_after]

string<date>

Filter results by date. Any parsable date format can be used.

Example:

"2025-01-01 or 2025-01-01 12:30:00 or 2025-01-01T12:30:00Z"

filter[provisioned_before]

string<date>

Filter results by date. Any parsable date format can be used.

Example:

"2025-01-01 or 2025-01-01 12:30:00 or 2025-01-01T12:30:00Z"

filter[provisioned_after]

string<date>

Filter results by date. Any parsable date format can be used.

Example:

"2025-01-01 or 2025-01-01 12:30:00 or 2025-01-01T12:30:00Z"

filter[deprovisioned_pending_deactivation]

string<boolean>

Get all active records that have been deprovisioned by the integration vendor

Example:

true

filter[deprovisioned_before]

string<date>

Filter results by date. Any parsable date format can be used.

Example:

"2025-01-01 or 2025-01-01 12:30:00 or 2025-01-01T12:30:00Z"

filter[deprovisioned_after]

string<date>

Filter results by date. Any parsable date format can be used.

Example:

"2025-01-01 or 2025-01-01 12:30:00 or 2025-01-01T12:30:00Z"

filter[trashed]

string

Can be a value of with (response will contain deleted items as well), only (will contain only deleted items), or any arbitrary value (will contain only not deleted items).

include

enum<string>[]

Available options:

manager-user,

manager-user-count,

manager-user-exists,

workspace-user,

workspace-user-count,

workspace-user-exists,

parent-user,

parent-user-count,

parent-user-exists,

secondary-users,

secondary-users-count,

secondary-users-exists,

direct-report-users,

direct-report-users-count,

direct-report-users-exists,

directory-identities,

directory-identities-count,

directory-identities-exists,

policy-conditions,

policy-conditions-count,

policy-conditions-exists,

policy-users,

policy-users-count,

policy-users-exists,

policy-rules-manifest,

policy-rules-manifest-count,

policy-rules-manifest-exists,

policy-rules-qualified,

policy-rules-qualified-count,

policy-rules-qualified-exists,

policy-rules-staged,

policy-rules-staged-count,

policy-rules-staged-exists,

policy-rulesets,

policy-rulesets-count,

policy-rulesets-exists

filter

string

page

string

sort

string

Response

The collection of DirectoryUserDetailedResponseData

string

required

Example:

"drusr_01hq8xyzabc123def456ghi789"

state

enum<string>

required

The state of the directory user


`staged` The record is staged and is only visible to administrators or in the API. Since Directory Users are managed by Directory Identities with your primary integration, this usually indicates that the user is staged and will be activated or onboarded soon. Staged users are not included in ruleset manifests until they are active users.
`active` The record is active.
`expiring` The `expires_at` value is set in the future for the record. You can run the `activate` action to remove the scheduled expiration.
`expired` The `expires_at` value is in the past and the record was deactivated.
`suspended` The record is temporarily suspended. This reflects the state of the primary Workspace Integration.
`deactivated` The record was deactivated in the primary Workspace Integration.

Available options:

staged,

active,

expiring,

expired,

suspended,

deactivated

Example:

"active"

manager_id

string | null

required

The ID of the manager

Example:

"drusr_01kam9z5z71f7r4hhrm2ydxkhn"

is_manager

boolean

required

Whether or not the user is a people manager with direct reports

Example:

true

first_name

string

required

The first (given) name of the user

Example:

"Dade"

last_name

string

required

The last (family) name of the user

Example:

"Murphy"

full_name

string

required

The first and last name of the user

Example:

"Dade Murphy"

string

required

The email address of the user

Example:

"[email protected]"

username

string | null

required

The username of the user. Unless overridden, this is usually the email address handle

Example:

"dmurphy"

badge_id

string | null

required

The badge ID number of the user. This value is dynamically obtained from the primary integration based on the badge_id_profile_key

employee_id

string | null

required

The employee ID number of the user. This value is dynamically obtained from the primary integration based on the employee_id_profile_key

employee_alt_id

string | null

required

An alternative/secondary employee ID number of the user. This value is dynamically obtained from the primary integration based on the employee_alt_id_profile_key

timestamp

DirectoryUserTimestampResponseData · object

required

The timestamps for the directory user record

Show child attributes

org

object

required

The user's organization metadata based on their dimension attributes

Show child attributes

Example:

{
  "cost_center": "CC-1234",
  "department": "Infrastructure",
  "division": "Engineering",
  "title": "Senior Engineer"
}

metadata

object

required

The user's custom key/value metadata added by someone or automation in your organization

Show child attributes

Example:

{
  "custom_field_1": "value1",
  "employee_type": "full-time",
  "desk_number": "42"
}

count

DirectoryUserCountResponseData · object

required

Counts of related resources for the directory user

Show child attributes

included

DirectoryUserIncludedResponseData · object

required

Related resources for the directory user. Use include parameter with a comma separated list of resources to fetch related data

Show child attributes

links

DirectoryUserLinkResponseData · object

required

API hyperlinks related to the directory user record

Show child attributes

Getting Started

Endpoints

List of Users

Authorizations

Query Parameters

Response