Admin Actions Management
Get Action Types
This call returns all the admin action categories that are audit logged.
Required Role
See Authentication for complete details on ensuring that the credentials you use for basic authentication belong to a user with the necessary role for this API call.
Required Role |
Category: Logs and Events Management Role Description: View logs and events |
HTTP method
GET
Request URI
api/v2/admins/{source}/actions
Request parameters
Parameter |
Description |
Sample Values |
adminDeviceSpaceId |
Required Parameter Type: Query Data Type: Number Device space ID of the administrator. |
1 |
source |
Parameter Type: Path Data Type: String Specifies the source from which the api call requests audit logged Admin actions. The api can request audit logged actions from two places, the Audit Logs page and Device Details Page. Sending a blank value for the source parameter returns all the categories and its action types. Sending deviceDetails, which means the source is Device Details Page, removes all the User related actions in the Certificate category, and returns all categories and action types as is. |
api/v2/admins/deviceDetails/actions or api/v2/admins/actions |
Response fields
Field |
Description |
category |
Returns the category name of logically grouped action types. |
actions |
An array containing all the action types under the category. Entries in this array have the following fields •id: Id of the action type •name: Action type name •category: Action type category •displayName: UI display name of the action type |
Sample request and response
Request
curl -sS -k -u <userName>:<password> -G https://[Ivanti EPMM]/api/v2/admins/actions?
adminDeviceSpaceId=1
Response
In the interest of brevity, this response sample contains only one category and all of its included actions.
[
{
"category": "MDM",
"actions": [
{
"id": 71,
"name": "INSTALL_MDM_PROFILE",
"category": "MDM",
"displayName": "Install MDM Profile"
},
{
"id": 72,
"name": "REMOVE_MDM_PROFILE",
"category": "MDM",
"displayName": "Remove MDM Profile"
},
{
"id": 73,
"name": "INSTALL_ENCRYPTED_SUBPROFILE",
"category": "MDM",
"displayName": "Install Encrypted Sub-Profile"
},
{
"id": 74,
"name": "REMOVE_ENCRYPTED_SUBPROFILE",
"category": "MDM",
"displayName": "Remove Encrypted Sub-Profile"
},
{
"id": 75,
"name": "INSTALL_PROV_PROFILE",
"category": "MDM",
"displayName": "Install Provisioning Profile"
},
{
"id": 76,
"name": "REMOVE_PROV_PROFILE",
"category": "MDM",
"displayName": "Remove Provisioning Profile"
},
{
"id": 77,
"name": "DEVICE_LOCK",
"category": "MDM",
"displayName": "Device Lock"
},
{
"id": 78,
"name": "CLEAR_PASSCODE",
"category": "MDM",
"displayName": "Clear Passcode"
},
{
"id": 79,
"name": "WIPE_DEVICE",
"category": "MDM",
"displayName": "Wipe Device"
},
{
"id": 80,
"name": "INSTALL_MANAGED_APP",
"category": "MDM",
"displayName": "Install Managed Application"
},
{
"id": 81,
"name": "REMOVE_MANAGED_APP",
"category": "MDM",
"displayName": "Remove Managed Application"
},
{
"id": 82,
"name": "APPLY_REDEMPTION_CODE",
"category": "MDM",
"displayName": "Apply Redemption Code"
},
{
"id": 83,
"name": "SETTINGS",
"category": "MDM",
"displayName": "Settings"
}
]
}
]