--- title: Absolute slug: connectors/absolute docTags: createdAt: 2026-06-09T16:30:26.468Z --- The Absolute connector enables automated interactions with Absolute's endpoint security management platform, facilitating device and security management tasks. Absolute provides robust endpoint security and device management solutions. This connector enables Swimlane Turbine users to manage device security by creating freeze messages, retrieving device details, managing device groups, and unenrolling devices. By integrating with Absolute, security teams can automate device management tasks, ensuring swift and consistent responses to security incidents and maintaining device compliance within the organization. ## Prerequisites To utilize the Absolute connector within Swimlane Turbine, ensure you have the following prerequisites: - Custom authentication with the following parameters: - URL: The endpoint URL for the Absolute API. - Token ID: Your unique identifier used for token-based authentication. - Token Secret: The secret key associated with your Token ID for secure access. ## Capabilities This Connector provides the following capabilities: - Create a Freeze Message - Get all Device Groups - Get an Unenroll Device Request - Get Device Details - Get Device Groups by Device - Get Freeze Messages - Unenroll Devices ## Notes - For more information on Absolute: [Absolute API Documentation](https://api.absolute.com/api-doc/doc.html#tag/Freeze) ## Additional Documentation - [Absolute Connector Documentation](https://docs.swimlane.com/connectors/absolute) - [Absolute API Documentation](https://api.absolute.com/api-doc/doc.html#tag/Freeze) - [Absolute Authentication Guide](https://docs.swimlane.com/authentication-guides/absolute) # Configurations ## Absolute Asset Authentication Authenticates using token\_id and token\_secret. ### Configuration Parameters | **Parameter** | **Description** | **Type** | **Required** | | ------------- | ---------------------------------- | -------- | ------------ | | url | A URL to the target host. | string | Required | | token\_id | Token ID | string | Required | | token\_secret | Token Secret | string | Required | | verify\_ssl | Verify SSL certificate | boolean | Optional | | http\_proxy | A proxy to route requests through. | string | Optional | # Actions ## Create a Freeze Message Displays a full-screen message on an Absolute-managed device, indicating it is frozen and inoperable, requiring 'content' and 'name'. ### Endpoint - **URL:** `/v3/actions/freeze/messages` - **Method:** `POST` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------- | -------- | ------------ | ------------------------------------------------------------------------------------------ | | `content` | string | Optional | The user-defined, HTML coded Freeze message.In between 1 and 4000 characters. | | `name` | string | Optional | The user-defined name of the Freeze message shown on the device when the device is frozen. | ### Input Example `{"json_body":{"content":"create a new content","name":"The user-defined name of the Freeze message"}}` ### Output | **Parameter** | **Type** | **Description** | | ------------------------------ | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `data` | object | Response data | | `data.messageUid` | string | Response data | | `metadata` | object | Response data | | `metadata.pagination` | object | Response data | | `metadata.pagination.nextPage` | string | Response data | ### Output Example `{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"data":{"messageUid":"b4d60860-4b3b-41ba-83ab-edd36717a834"},"metadata":{"pagination":{}}}}` ## Get all Device Groups Retrieve details of all existing device groups within the Absolute platform. ### Endpoint - **URL:** `/v3/configurations/device-groups/groups` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ---------------------------------- | -------- | ------------ | --------------------------------------------------------------------------------------------------------- | | `parameters.nextPage` | string | Optional | The pagination token for the next page of results. | | `parameters.pageSize` | string | Optional | The number of records to be returned per page Default 100 Maximum 500. | | `parameters.deviceGroupUid` | string | Optional | Filters the results to include responses where deviceGroupUid equals the given value. | | `parameters.deviceGroupUidAnyOf` | string | Optional | Filters the results to include responses where deviceGroupUid is any of the given comma-separated values. | | `parameters.displayName` | string | Optional | Filters results to include responses where displayName equals the given value. | | `parameters.displayNameStartsWith` | string | Optional | Filters results to include responses where displayName starts with the given value. | | `parameters.groupType` | string | Optional | Filters results to include responses where groupType equals the given value. | ### Input Example `{"parameters":{"nextPage":"string","pageSize":"100","deviceGroupUid":"01a3d36a-9f62-4092-8c48-6db4233ee99b","deviceGroupUidAnyOf":"string","displayName":"string","displayNameStartsWith":"string","groupType":"string"}}` ### Output | **Parameter** | **Type** | **Description** | | ------------------------------ | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `data` | array | Response data | | `data.deviceGroupUid` | string | Response data | | `data.groupType` | string | Response data | | `data.displayName` | string | Response data | | `data.description` | string | Response data | | `metadata` | object | Response data | | `metadata.pagination` | object | Response data | | `metadata.pagination.nextPage` | string | Response data | ### Output Example `{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"data":[{}],"metadata":{"pagination":{}}}}` ## Get an Unenroll Device Request Retrieve details of an Unenroll Device request in Absolute using the unique request identifier (requestUid). ### Endpoint - **URL:** `/v3/actions/requests/unenroll/{{requestUid}}` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ---------------------------- | -------- | ------------ | ------------------------------------------------------------------ | | `path_parameters.requestUid` | string | Required | The system-defined unique identifier of the Device Action request. | ### Input Example `{"path_parameters":{"requestUid":"23dbd460-0547-466d-a655-99d9340ff598"}}` ### Output | **Parameter** | **Type** | **Description** | | ---------------------------- | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `data` | object | Response data | | `data.totalDevices` | number | Response data | | `data.pending` | number | Response data | | `data.processing` | number | Response data | | `data.completed` | number | Response data | | `data.canceled` | number | Response data | | `data.failed` | number | Response data | | `data.requestId` | string | Response data | | `data.requestUid` | string | Response data | | `data.requestStatus` | string | Response data | | `data.createdDateTimeUtc` | string | Response data | | `data.updatedDateTimeUtc` | string | Response data | | `data.requester` | string | Response data | | `data.excludeMissingDevices` | boolean | Response data | | `metadata` | object | Response data | | `metadata.pagination` | object | Response data | ### Output Example `{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"data":{"totalDevices":0,"pending":0,"processing":0,"completed":0,"canceled":0,"failed":0,"requestId":"string","requestUid":"23dbd460-0547-466d-a655-99d9340ff598","requestStatus":"string","createdDateTimeUtc":"2019-08-24T14:15:22Z","updatedDateTimeUtc":"2019-08-24T14:15:22Z","requester":"string","excludeMissingDevices":true},"metadata":{"pagination":{}}}}` ## Get Device Details Retrieve detailed information about devices registered in your Absolute account. ### Endpoint - **URL:** `/v3/reporting/devices` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ------------------------------------ | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ | | `parameters.sortBy` | string | Optional | The sorting field and the direction of sorting. | | `parameters.select` | string | Optional | A comma-delimited list of fields to be returned in the results, You cannot use both the top level object and nested parameters at the same time. | | `parameters.nextPage` | string | Optional | The pagination token for the next page of results. | | `parameters.pageSize` | string | Optional | The number of records to be returned per page. | | `parameters.agentStatus` | string | Optional | Filters results to include responses where agentStatus equals the given value. | | `parameters.agentStatusEmpty` | boolean | Optional | Filters results to include responses where agentStatus is empty or null. | | `parameters.agentStatusNot` | string | Optional | Filters results to include responses where agentStatus does not equal the given value. Can be used multiple times with different values. | | `parameters.agentVersion` | string | Optional | Filters results to include responses where agentVersion equals the given value. | | `parameters.agentVersionNot` | string | Optional | Filters results to include responses where agentVersion does not equal the given value. Can be used multiple times with different values. | | `parameters.bootDevice` | string | Optional | Filters results to include responses where bootDevice equals the given value. | | `parameters.bootDeviceNot` | string | Optional | Filters results to include responses where bootDevice does not equal the given value. Can be used multiple times with different values. | | `parameters.bootDeviceNotStartsWith` | string | Optional | Filters results to include responses where bootDevice does not start with the given value. Can be used multiple times with different values. | | `parameters.bootDeviceStartsWith` | string | Optional | Filters results to include responses where bootDevice starts with the given value. | | `parameters.bssId` | string | Optional | Filters results to include responses where bssId equals the given value. | | `parameters.bssIdNot` | string | Optional | Filters results to include responses where bssId does not equal the given value. Can be used multiple times with different values. | | `parameters.classification` | string | Optional | Filters results to include responses where classification equals the given value. | | `parameters.classificationNot` | string | Optional | Filters results to include responses where classification does not equal the given value. Can be used multiple times with different values. | | `parameters.ctesVersion` | string | Optional | Filters results to include responses where ctesVersion equals the given value. | | `parameters.ctesVersionNot` | string | Optional | Filters results to include responses where ctesVersion does not equal the given value. Can be used multiple times with different values. | | `parameters.currentNetworkName` | string | Optional | Filters results to include responses where currentNetworkName equals the given value. | | `parameters.currentNetworkNameEmpty` | string | Optional | Filters results to include responses where currentNetworkName is empty or null. | | `parameters.currentNetworkNameNot` | string | Optional | Filters results to include responses where currentNetworkName does not equal the given value. | | `parameters.currentUsername` | string | Optional | Filters results to include responses where currentUsername equals the given value. | | `parameters.currentUsernameContains` | string | Optional | Filters results to include responses where currentUsername contains the given value. | | `parameters.currentUsernameEmpty` | boolean | Optional | Filters results to include responses where currentUsername is empty or null. | ### Input Example `{"parameters":{"sortBy":"string","select":"string","nextPage":"string","pageSize":10,"agentStatus":"active","agentStatusEmpty":true,"agentStatusNot":"active","agentVersion":"string","agentVersionNot":"string","bootDevice":"string","bootDeviceNot":"string","bootDeviceNotStartsWith":"string","bootDeviceStartsWith":"string","bssId":"string","bssIdNot":"string","classification":"string","classificationNot":"string","ctesVersion":"string","ctesVersionNot":"string","currentNetworkName":"Example Name","currentNetworkNameEmpty":"Example Name","currentNetworkNameNot":"Example Name","currentUsername":"Example Name","currentUsernameContains":"Example Name","currentUsernameEmpty":true,"currentUsernameEndsWith":"Example Name","currentUsernameNot":"Example Name","currentUsernameNotStartsWith":"Example Name","currentUsernameStartsWith":"Example Name","defaultGateway":"string","defaultGatewayNot":"string","defaultGatewayNotStartsWith":"string","defaultGatewayStartsWith":"string","deviceFreezeActionStatusScore":123,"deviceFreezeReportingStatusesContains":"active","deviceFreezeStatusCode":"active","deviceName":"Example Name","deviceNameEmpty":true,"deviceNameNot":"Example Name","deviceNameNotStartsWith":"Example Name","deviceNameStartsWith":"Example Name","deviceStatus":"active","deviceStatusNot":"active","deviceUid":"string","deviceUidNot":"string","dfCalcStatus":"active","dfCalcStatusNot":"active","dfComponentStatus":"active","dfComponentStatusNot":"active","dfStatusEnabled":true}}` ### Output | **Parameter** | **Type** | **Description** | | ------------------------------- | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `data` | array | Response data | | `data.deviceUid` | string | Response data | | `data.accountUid` | string | Response data | | `data.policyGroupName` | string | Response data | | `data.lastConnectedDateTimeUtc` | string | Response data | | `data.dlpStatus` | object | Response data | | `data.dlpStatus.isEnabled` | boolean | Response data | | `data.dlpStatus.featureType` | string | Response data | | `data.espStatus` | object | Response data | | `data.espStatus.isEnabled` | boolean | Response data | | `data.espStatus.featureType` | string | Response data | | `metadata` | object | Response data | | `metadata.pagination` | object | Response data | | `metadata.pagination.nextPage` | string | Response data | ### Output Example `{"status_code":200,"reason":"OK","json_body":{"data":[{}],"metadata":{"pagination":{}}}}` ## Get Device Groups by Device Retrieve all device groups associated with a specific device in Absolute using the unique identifier (deviceUid). ### Endpoint - **URL:** `/v3/configurations/device-groups/devices/{{deviceUid}}/groups` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | --------------------------- | -------- | ------------ | --------------------------------------------------- | | `path_parameters.deviceUid` | string | Required | The system-defined unique identifier of the device. | ### Input Example `{"path_parameters":{"deviceUid":"01a3d36a-9f62-4092-8c48-6db4233ee99b"}}` ### Output | **Parameter** | **Type** | **Description** | | ------------------------------ | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `data` | array | Response data | | `data.deviceGroupUid` | string | Response data | | `data.groupType` | string | Response data | | `data.displayName` | string | Response data | | `data.description` | string | Response data | | `metadata` | object | Response data | | `metadata.pagination` | object | Response data | | `metadata.pagination.nextPage` | string | Response data | ### Output Example `{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"data":[{}],"metadata":{"pagination":{}}}}` ## Get Freeze Messages Gathers all configured Freeze messages from Absolute, offering a comprehensive overview of system alerts. ### Endpoint - **URL:** `/v3/actions/freeze/messages` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | --------------------- | -------- | ------------ | ---------------------------------------------------------------------- | | `parameters.nextPage` | string | Optional | The pagination token for the next page Each page contains 100 records | | `parameters.pageSize` | string | Optional | The number of records to be returned per page Default 100 Maximum 500. | ### Input Example `{"parameters":{"nextPage":"100records","pageSize":"100"}}` ### Output | **Parameter** | **Type** | **Description** | | ------------------------------ | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `data` | array | Response data | | `data.name` | string | Response data | | `data.content` | string | Response data | | `data.createdBy` | string | Response data | | `data.changedBy` | string | Response data | | `data.messageUid` | string | Response data | | `data.createdDateTimeUtc` | string | Response data | | `data.changedDateTimeUtc` | string | Response data | | `metadata` | object | Response data | | `metadata.pagination` | object | Response data | | `metadata.pagination.nextPage` | string | Response data | ### Output Example `{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"data":[{}],"metadata":{"pagination":{}}}}` ## Unenroll Devices Initiates the unenrollment of specified devices from Absolute using their unique deviceUids. ### Endpoint - **URL:** `/v3/actions/requests/unenroll` - **Method:** `POST` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------------- | -------- | ------------ | ---------------------------------------------------------------------------------------------- | | `deviceUids` | array | Optional | Unique identifier | | `excludeMissingDevices` | boolean | Optional | Indicates whether devices that have been reported Missing should be excluded from the request. | ### Input Example `{"json_body":{"deviceUids":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"excludeMissingDevices":true}}` ### Output | **Parameter** | **Type** | **Description** | | ------------------------------ | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `data` | object | Response data | | `data.requestUid` | string | Response data | | `metadata` | object | Response data | | `metadata.pagination` | object | Response data | | `metadata.pagination.nextPage` | string | Response data | ### Output Example `{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"data":{"requestUid":"23dbd460-0547-466d-a655-99d9340ff598"},"metadata":{"pagination":{}}}}` # Response Headers | **Header** | **Description** | **Example** | | ------------------------- | -------------------------------------------------------- | ----------- | | CF-Cache-Status | HTTP response header: CF-Cache-Status | | | CF-RAY | HTTP response header: CF-RAY | | | Connection | HTTP response header: Connection | | | Content-Encoding | HTTP response header: Content-Encoding | | | Content-Type | The media type of the resource | | | Date | The date and time at which the message was originated | | | Feature-Policy | HTTP response header: Feature-Policy | | | Link | HTTP response header: Link | | | Referrer-Policy | HTTP response header: Referrer-Policy | | | Server | Information about the software used by the origin server | | | Set-Cookie | HTTP response header: Set-Cookie | | | Strict-Transport-Security | HTTP response header: Strict-Transport-Security | | | Transfer-Encoding | HTTP response header: Transfer-Encoding | | | Vary | HTTP response header: Vary | | | X-Content-Type-Options | HTTP response header: X-Content-Type-Options | | | X-Frame-Options | HTTP response header: X-Frame-Options | |