---
title: "Remove Value From List"
method: POST
path: "/{WSID}/{version}/profiles/properties/list-remove"
tags: ["User Properties"]
---

# Remove Value From List

`POST /{WSID}/{version}/profiles/properties/list-remove`

This API enables you to remove existing values from the list type properties of your users listed in your [User Profiles](../user-profiles-overview). If the specified distinct ID or list property doesn't exist, it simply accepts the remove request and ignores it.

**Note:** This API can only be used to remove values from list and can remove only one value from a property at a time. To unset (nullify) other property types, please use [Unset User Property API.](./unset-user-property)

## Path parameters

- `WSID` string, required
- `version` 'live' | 'test', required

## Request body

- RemoveFromUserPropertyList
  - `$remove` RemoveFromUserPropertyListFields, required — Enter the property name as JSON key and the value to remove as JSON value
  - `distinct_id` string, required — Enter the distinct ID that you use to identify the recipient.

## Response `202`

Request has been accepted and will be processed asynchronously.

- object
  - `request_id` string, required

## Other responses

- `400` — $remove object is empty
- `401` — API Key or Workspace ID is invalid. User is unauthorised.

---

[API](https://skmtc.net/fynoio/apis/fyno-rest-api.md) · [All operations](https://skmtc.net/fynoio/apis/fyno-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fynoio/fyno-rest-api/versions/021088e9cb30/schema)