---
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.

## Changes

- **2025-02-17** `ee2cf82f4e6a` — 5 info
  - added `subschema #3` to the `$remove/additionalProperties/` request property `oneOf` list
  - the response property `_message` became required for the status `400`
  - the response property `_message` became required for the status `401`
  - the response property `status` became required for the status `400`
  - …1 more
- **2025-02-12** `f9c2e33f3247` — 3 warning
  - removed the request property `$remove/property_1`
  - removed the request property `$remove/property_2`
  - removed the request property `$remove/property_n`
- **2025-02-12** `4a67858d11ce` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/fynoio/apis/fyno-rest-api/changes/:WSID/:version/profiles/properties/list-remove/post.md)

---

[API](https://skmtc.dev/fynoio/apis/fyno-rest-api.md) · [All operations](https://skmtc.dev/fynoio/apis/fyno-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fynoio/fyno-rest-api/revisions/ee288e1ee67d/schema)