> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# persona-lists

> Persona Lists - Watchlists and list items

**Server path:** `/persona-lists` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                                                  | Description                               |
| --------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- |
| [`persona_lists_archive_a_browser_fingerprint_list_item`](#persona_lists_archive_a_browser_fingerprint_list_item)     | Archive a Browser Fingerprint List Item   |
| [`persona_lists_archive_a_country_list_item`](#persona_lists_archive_a_country_list_item)                             | Archive a Country List Item               |
| [`persona_lists_archive_a_device_fingerprint_list_item`](#persona_lists_archive_a_device_fingerprint_list_item)       | Archive a Device Fingerprint List Item    |
| [`persona_lists_archive_a_field_list_item`](#persona_lists_archive_a_field_list_item)                                 | Archive a Field List Item                 |
| [`persona_lists_archive_a_geolocation_list_item`](#persona_lists_archive_a_geolocation_list_item)                     | Archive a Geolocation List Item           |
| [`persona_lists_archive_a_government_id_number_list_item`](#persona_lists_archive_a_government_id_number_list_item)   | Archive a Government ID Number List Item  |
| [`persona_lists_archive_a_list`](#persona_lists_archive_a_list)                                                       | Archive a List                            |
| [`persona_lists_archive_a_name_list_item`](#persona_lists_archive_a_name_list_item)                                   | Archive a Name List Item                  |
| [`persona_lists_archive_a_phone_number_list_item`](#persona_lists_archive_a_phone_number_list_item)                   | Archive a Phone Number List Item          |
| [`persona_lists_archive_a_string_list_item`](#persona_lists_archive_a_string_list_item)                               | Archive a String List Item                |
| [`persona_lists_archive_an_email_address_list_item`](#persona_lists_archive_an_email_address_list_item)               | Archive an Email Address List Item        |
| [`persona_lists_archive_an_ip_address_list_item`](#persona_lists_archive_an_ip_address_list_item)                     | Archive an IP Address List Item           |
| [`persona_lists_create_a_browser_fingerprint_list`](#persona_lists_create_a_browser_fingerprint_list)                 | Create a Browser Fingerprint List         |
| [`persona_lists_create_a_browser_fingerprint_list_item`](#persona_lists_create_a_browser_fingerprint_list_item)       | Create a Browser Fingerprint List Item    |
| [`persona_lists_create_a_country_list`](#persona_lists_create_a_country_list)                                         | Create a Country List                     |
| [`persona_lists_create_a_country_list_item`](#persona_lists_create_a_country_list_item)                               | Create a Country List Item                |
| [`persona_lists_create_a_device_fingerprint_list_item`](#persona_lists_create_a_device_fingerprint_list_item)         | Create a Device Fingerprint List Item     |
| [`persona_lists_create_a_field_list_item`](#persona_lists_create_a_field_list_item)                                   | Create a Field List Item                  |
| [`persona_lists_create_a_geolocation_list`](#persona_lists_create_a_geolocation_list)                                 | Create a Geolocation List                 |
| [`persona_lists_create_a_geolocation_list_item`](#persona_lists_create_a_geolocation_list_item)                       | Create a Geolocation List Item            |
| [`persona_lists_create_a_government_id_number_list`](#persona_lists_create_a_government_id_number_list)               | Create a Government ID Number List        |
| [`persona_lists_create_a_government_id_number_list_item`](#persona_lists_create_a_government_id_number_list_item)     | Create a Government ID Number List Item   |
| [`persona_lists_create_a_name_list`](#persona_lists_create_a_name_list)                                               | Create a Name List                        |
| [`persona_lists_create_a_name_list_item`](#persona_lists_create_a_name_list_item)                                     | Create a Name List Item                   |
| [`persona_lists_create_a_phone_number_list`](#persona_lists_create_a_phone_number_list)                               | Create a Phone Number List                |
| [`persona_lists_create_a_phone_number_list_item`](#persona_lists_create_a_phone_number_list_item)                     | Create a Phone Number List Item           |
| [`persona_lists_create_a_string_list_item`](#persona_lists_create_a_string_list_item)                                 | Create a String List Item                 |
| [`persona_lists_create_a_strings_list`](#persona_lists_create_a_strings_list)                                         | Create a Strings List                     |
| [`persona_lists_create_an_email_address_list`](#persona_lists_create_an_email_address_list)                           | Create an Email Address List              |
| [`persona_lists_create_an_email_address_list_item`](#persona_lists_create_an_email_address_list_item)                 | Create an Email Address List Item         |
| [`persona_lists_create_an_ip_address_list`](#persona_lists_create_an_ip_address_list)                                 | Create an IP Address List                 |
| [`persona_lists_create_an_ip_address_list_item`](#persona_lists_create_an_ip_address_list_item)                       | Create an IP Address List Item            |
| [`persona_lists_list_all_lists`](#persona_lists_list_all_lists)                                                       | List all Lists                            |
| [`persona_lists_retrieve_a_browser_fingerprint_list_item`](#persona_lists_retrieve_a_browser_fingerprint_list_item)   | Retrieve a Browser Fingerprint List Item  |
| [`persona_lists_retrieve_a_country_list_item`](#persona_lists_retrieve_a_country_list_item)                           | Retrieve a Country List Item              |
| [`persona_lists_retrieve_a_device_fingerprint_list_item`](#persona_lists_retrieve_a_device_fingerprint_list_item)     | Retrieve a Device Fingerprint List Item   |
| [`persona_lists_retrieve_a_field_list_item`](#persona_lists_retrieve_a_field_list_item)                               | Retrieve a Field List Item                |
| [`persona_lists_retrieve_a_geolocation_list_item`](#persona_lists_retrieve_a_geolocation_list_item)                   | Retrieve a Geolocation List Item          |
| [`persona_lists_retrieve_a_government_id_number_list_item`](#persona_lists_retrieve_a_government_id_number_list_item) | Retrieve a Government ID Number List Item |
| [`persona_lists_retrieve_a_list`](#persona_lists_retrieve_a_list)                                                     | Retrieve a List                           |
| [`persona_lists_retrieve_a_name_list_item`](#persona_lists_retrieve_a_name_list_item)                                 | Retrieve a Name List Item                 |
| [`persona_lists_retrieve_a_phone_number_list_item`](#persona_lists_retrieve_a_phone_number_list_item)                 | Retrieve a Phone Number List Item         |
| [`persona_lists_retrieve_a_string_list_item`](#persona_lists_retrieve_a_string_list_item)                             | Retrieve a String List Item               |
| [`persona_lists_retrieve_an_email_address_list_item`](#persona_lists_retrieve_an_email_address_list_item)             | Retrieve an Email Address List Item       |
| [`persona_lists_retrieve_an_ip_address_list_item`](#persona_lists_retrieve_an_ip_address_list_item)                   | Retrieve an IP Address List Item          |

***

## persona\_lists\_archive\_a\_browser\_fingerprint\_list\_item

Archive a Browser Fingerprint List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to archive.                                                                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to archive."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_archive\_a\_country\_list\_item

Archive a Country List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to archive.                                                                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to archive."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_archive\_a\_device\_fingerprint\_list\_item

Archive a Device Fingerprint List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to archive.                                                                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to archive."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_archive\_a\_field\_list\_item

Archive a Field List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to archive.                                                                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to archive."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_archive\_a\_geolocation\_list\_item

Archive a Geolocation List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to archive.                                                                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to archive."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_archive\_a\_government\_id\_number\_list\_item

Archive a Government ID Number List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to archive.                                                                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to archive."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_archive\_a\_list

Archive a List

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-id`         | string | Yes      | —       | ID of the list to archive                                                                                                                                                                                                                                                            |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-id": {
        "type": "string",
        "description": "ID of the list to archive"
      }
    },
    "required": [
      "PCID",
      "list-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_archive\_a\_name\_list\_item

Archive a Name List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to archive.                                                                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to archive."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_archive\_a\_phone\_number\_list\_item

Archive a Phone Number List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to archive.                                                                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to archive."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_archive\_a\_string\_list\_item

Archive a String List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to archive.                                                                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to archive."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_archive\_an\_email\_address\_list\_item

Archive an Email Address List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to archive.                                                                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to archive."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_archive\_an\_ip\_address\_list\_item

Archive an IP Address List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to archive.                                                                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to archive."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_create\_a\_browser\_fingerprint\_list

Create a Browser Fingerprint List

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `data`            | object | No       | —       | The data value                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "data": {
        "type": "object",
        "description": "The data value",
        "properties": {
          "attributes": {
            "type": "object",
            "description": "The attributes value"
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_create\_a\_browser\_fingerprint\_list\_item

Create a Browser Fingerprint List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `data`            | object | No       | —       | The data value                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "data": {
        "type": "object",
        "description": "The data value",
        "properties": {
          "attributes": {
            "type": "object",
            "description": "The attributes value"
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_create\_a\_country\_list

Create a Country List

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `data`            | object | No       | —       | The data value                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "data": {
        "type": "object",
        "description": "The data value",
        "properties": {
          "attributes": {
            "type": "object",
            "description": "The attributes value"
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_create\_a\_country\_list\_item

Create a Country List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `data`            | object | No       | —       | The data value                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "data": {
        "type": "object",
        "description": "The data value",
        "properties": {
          "attributes": {
            "type": "object",
            "description": "The attributes value"
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_create\_a\_device\_fingerprint\_list\_item

Create a Device Fingerprint List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `data`            | object | No       | —       | The data value                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "data": {
        "type": "object",
        "description": "The data value",
        "properties": {
          "attributes": {
            "type": "object",
            "description": "The attributes value"
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_create\_a\_field\_list\_item

Create a Field List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `data`            | object | No       | —       | The data value                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "data": {
        "type": "object",
        "description": "The data value",
        "properties": {
          "attributes": {
            "type": "object",
            "description": "The attributes value"
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_create\_a\_geolocation\_list

Create a Geolocation List

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `data`            | object | No       | —       | The data value                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "data": {
        "type": "object",
        "description": "The data value",
        "properties": {
          "attributes": {
            "type": "object",
            "description": "The attributes value"
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_create\_a\_geolocation\_list\_item

Create a Geolocation List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `data`            | object | No       | —       | The data value                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "data": {
        "type": "object",
        "description": "The data value",
        "properties": {
          "attributes": {
            "type": "object",
            "description": "The attributes value"
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_create\_a\_government\_id\_number\_list

Create a Government ID Number List

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `data`            | object | No       | —       | The data value                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "data": {
        "type": "object",
        "description": "The data value",
        "properties": {
          "attributes": {
            "type": "object",
            "description": "The attributes value"
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_create\_a\_government\_id\_number\_list\_item

Create a Government ID Number List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `data`            | object | No       | —       | The data value                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "data": {
        "type": "object",
        "description": "The data value",
        "properties": {
          "attributes": {
            "type": "object",
            "description": "The attributes value"
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_create\_a\_name\_list

Create a Name List

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `data`            | object | No       | —       | The data value                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "data": {
        "type": "object",
        "description": "The data value",
        "properties": {
          "attributes": {
            "type": "object",
            "description": "The attributes value"
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_create\_a\_name\_list\_item

Create a Name List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `data`            | object | No       | —       | The data value                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "data": {
        "type": "object",
        "description": "The data value",
        "properties": {
          "attributes": {
            "type": "object",
            "description": "The attributes value"
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_create\_a\_phone\_number\_list

Create a Phone Number List

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `data`            | object | No       | —       | The data value                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "data": {
        "type": "object",
        "description": "The data value",
        "properties": {
          "attributes": {
            "type": "object",
            "description": "The attributes value"
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_create\_a\_phone\_number\_list\_item

Create a Phone Number List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `data`            | object | No       | —       | The data value                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "data": {
        "type": "object",
        "description": "The data value",
        "properties": {
          "attributes": {
            "type": "object",
            "description": "The attributes value"
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_create\_a\_string\_list\_item

Create a String List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `data`            | object | No       | —       | The data value                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "data": {
        "type": "object",
        "description": "The data value",
        "properties": {
          "attributes": {
            "type": "object",
            "description": "The attributes value"
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_create\_a\_strings\_list

Create a Strings List

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `data`            | object | No       | —       | The data value                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "data": {
        "type": "object",
        "description": "The data value",
        "properties": {
          "attributes": {
            "type": "object",
            "description": "The attributes value"
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_create\_an\_email\_address\_list

Create an Email Address List

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `data`            | object | No       | —       | The data value                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "data": {
        "type": "object",
        "description": "The data value",
        "properties": {
          "attributes": {
            "type": "object",
            "description": "The attributes value"
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_create\_an\_email\_address\_list\_item

Create an Email Address List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `data`            | object | No       | —       | The data value                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "data": {
        "type": "object",
        "description": "The data value",
        "properties": {
          "attributes": {
            "type": "object",
            "description": "The attributes value"
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_create\_an\_ip\_address\_list

Create an IP Address List

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `data`            | object | No       | —       | The data value                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "data": {
        "type": "object",
        "description": "The data value",
        "properties": {
          "attributes": {
            "type": "object",
            "description": "The attributes value"
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_create\_an\_ip\_address\_list\_item

Create an IP Address List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `data`            | object | No       | —       | The data value                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "data": {
        "type": "object",
        "description": "The data value",
        "properties": {
          "attributes": {
            "type": "object",
            "description": "The attributes value"
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_list\_all\_lists

List all Lists

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                             |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                 |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                      |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                               |
| `page`            | object | No       | —       | Page number for pagination                                                                                                                                                                                                                              |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details. |
| `filter`          | object | No       | —       | The filter value                                                                                                                                                                                                                                        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "page": {
        "type": "object",
        "description": "Page number for pagination",
        "properties": {
          "after": {
            "type": "string",
            "description": "Object ID for pagination cursor"
          },
          "before": {
            "type": "string",
            "description": "Object ID for pagination cursor"
          },
          "size": {
            "type": "number",
            "description": "Limit on the number of objects returned"
          }
        }
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "filter": {
        "type": "object",
        "description": "The filter value",
        "properties": {
          "status": {
            "type": "string",
            "description": "Filter lists by status",
            "enum": [
              "active",
              "archived"
            ]
          }
        }
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_retrieve\_a\_browser\_fingerprint\_list\_item

Retrieve a Browser Fingerprint List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to retrieve.                                                                                                                                                                                                                                                         |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to retrieve."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_retrieve\_a\_country\_list\_item

Retrieve a Country List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to archive.                                                                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to archive."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_retrieve\_a\_device\_fingerprint\_list\_item

Retrieve a Device Fingerprint List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to retrieve.                                                                                                                                                                                                                                                         |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to retrieve."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_retrieve\_a\_field\_list\_item

Retrieve a Field List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to archive.                                                                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to archive."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_retrieve\_a\_geolocation\_list\_item

Retrieve a Geolocation List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to archive.                                                                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to archive."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_retrieve\_a\_government\_id\_number\_list\_item

Retrieve a Government ID Number List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to archive.                                                                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to archive."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_retrieve\_a\_list

Retrieve a List

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-id`         | string | Yes      | —       | ID of the list to retrieve                                                                                                                                                                                                                                                           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-id": {
        "type": "string",
        "description": "ID of the list to retrieve"
      }
    },
    "required": [
      "PCID",
      "list-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_retrieve\_a\_name\_list\_item

Retrieve a Name List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to archive.                                                                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to archive."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_retrieve\_a\_phone\_number\_list\_item

Retrieve a Phone Number List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to archive.                                                                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to archive."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_retrieve\_a\_string\_list\_item

Retrieve a String List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to archive.                                                                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to archive."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_retrieve\_an\_email\_address\_list\_item

Retrieve an Email Address List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to archive.                                                                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to archive."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>

***

## persona\_lists\_retrieve\_an\_ip\_address\_list\_item

Retrieve an IP Address List Item

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                                                                                                                                                                          |
| ----------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Key-Inflection`  | string | No       | —       | Determines casing for the API response.                                                                                                                                                                                                                                              |
| `Idempotency-Key` | string | No       | —       | Ensures the request is idempotent.                                                                                                                                                                                                                                                   |
| `Persona-Version` | string | No       | —       | Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).                                                                                                                                                                            |
| `include`         | string | No       | —       | A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. |
| `fields`          | object | No       | —       | Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details.                              |
| `list-item-id`    | string | Yes      | —       | ID of list item to archive.                                                                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Key-Inflection": {
        "type": "string",
        "description": "Determines casing for the API response.",
        "enum": [
          "camel",
          "kebab",
          "snake"
        ]
      },
      "Idempotency-Key": {
        "type": "string",
        "description": "Ensures the request is idempotent."
      },
      "Persona-Version": {
        "type": "string",
        "description": "Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).",
        "enum": [
          "2025-12-08",
          "2025-10-27",
          "2023-01-05",
          "2022-09-01",
          "2021-08-18",
          "2021-07-05",
          "2021-02-21",
          "2020-05-18"
        ]
      },
      "include": {
        "type": "string",
        "description": "A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details."
      },
      "fields": {
        "type": "object",
        "description": "Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details."
      },
      "list-item-id": {
        "type": "string",
        "description": "ID of list item to archive."
      }
    },
    "required": [
      "PCID",
      "list-item-id"
    ]
  }
  ```
</Expandable>