# REST Resource: projects.locations.instances.customLists

- [Resource: CustomList](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.customLists#CustomList)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.customLists#CustomList.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.customLists#METHODS_SUMMARY)

## Resource: CustomList

This service is available for customers who migrated SOAR to a customer managed project and have the Chronicle API enabled. CustomList resource. The custom list is a list of objects, that can be saved as a shared resource, and can be used by playbooks.

| JSON representation |
|---|
| ``` { "name": string, "category": string, "entityIdentifier": string, "environments": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The resource name of the custom list. |
| `category` | `string` Required. The value of the custom list. Maximum length: 1024 characters |
| `entityIdentifier` | `string` Required. The key of the custom list. Maximum length: 2048 characters |
| `environments` | `string` Required. The environments to which the custom list is associated. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.customLists/batchDelete` | Deletes multiple custom list entries in a single operation. |
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.customLists/create` | Creates a new custom list entry. |
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.customLists/delete` | Deletes a specific custom list entry. |
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.customLists/export` | Exports selected custom lists as a CSV file. |
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.customLists/get` | Gets a single custom list entry by its resource name. |
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.customLists/import` | Imports multiple custom list entries from a CSV file. |
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.customLists/list` | Lists all custom list entries in the instance. |
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.customLists/patch` | Updates an existing custom list entry. |