# Retrieve library entries for sensors or remote actions

Get a list of available sensor or remote action scripts. You can filter by platform and paginate the results.

## Endpoints

`GET /intelligence/sensors/api/libraries`

## Request URL

https://[{serverurl}](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)/intelligence/sensors/api/libraries

## Scope

`DesktopCentralCloud.Platform.READ`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Accept** `string` — **Mandatory**
  - `application/SensorsList.v1+json`

### Query Parameters

- **type** `string` — **Mandatory**
  - Library type to retrieve: `'sensor'` or `'remote_action'`
- **platform** `string` — Optional
  - Filter by platform: WINDOWS, LINUX, MAC. Default: all
- **offset** `string` — Optional
  - Pagination offset. Default: 0
- **limit** `string` — Optional
  - Maximum number of results. Default: 1000
- **filter** `string` — Optional
  - Text filter to search library entries by name

## Sample Request

```curl
curl --request GET \
  --url 'https://appdomains/intelligence/sensors/api/libraries?type=SOME_STRING_VALUE' \
  --header 'Accept: application/SensorsList.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

#### Response Body — `application/json`

`JSON Object`

- **libraryName** `string`
  - Script name in the library (e.g., `'CollectDisk.ps1'`)
- **libraryId** `long`
  - Unique identifier of the library script
- **description** `string`
  - Description of what the script does
- **libraryType** `string`
  - Script file extension: ps1, vbs, bat, or sh
- **platform** `string`
  - Platform code: 1=Windows, 2=Mac, 3=Linux, 4=All

### HTTP Code 500

#### Response Body — `application/json`

`JSON Object`

- **errorCode** `string`
  - Error code for library retrieval failure
- **errorMessage** `string`
  - Details about the library retrieval failure

## Possible Response Codes

- **200** — HTTP code
- **500** — HTTP code

## Sample Response: HTTP 200

Sensor library entries for Windows

```json
[
  {
    "libraryName": "CollectDisk.ps1",
    "libraryId": 4501,
    "description": "Collect disk usage",
    "libraryType": "ps1",
    "platform": 1
  }
]
```

## Sample Response: HTTP 500

Could not load library entries

```json
{
  "errorMessage": "Failed to retrieve sensor library entries.",
  "errorCode": "LIBRARY_FETCH_ERROR"
}
```

## Rate Limiting

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 30 | **Lock period:** 5 minutes

Duration - Time window for the threshold.  
Threshold - Number of API calls allowed within the specified duration.  
Lock Period - Wait time before consecutive API requests.