---
title: "Remove User from a User List"
method: DELETE
path: "/api/{account}/user-lists/{userListId}/users/{userId}"
tags: ["User List Collections"]
---

# Remove User from a User List

`DELETE /api/{account}/user-lists/{userListId}/users/{userId}`

Remove User from OnlyFans User List

## Response `200`

- object
  - `data` object
    - `list` object
      - `id` integer
      - `type` string
      - `name` string
      - `usersCount` integer
      - `postsCount` integer
      - `order` string
      - `direction` string
      - `canUpdate` boolean
      - `canDelete` boolean
      - `canManageUsers` boolean
      - `canAddUsers` boolean
      - `canPinnedToFeed` boolean
      - `isPinnedToFeed` boolean
      - `canPinnedToChat` boolean
      - `isPinnedToChat` boolean
      - `sortList` unknown[]
        - unknown
      - `users` object[]
        - `view` string
        - `id` integer
        - `name` string
        - `username` string
        - `isVerified` boolean
        - `avatar` string
        - `avatarThumbs` object
          - `c50` string
          - `c144` string
    - `userState` object
      - `id` integer
      - `type` string
      - `name` string
      - `hasUser` boolean
      - `canAddUser` boolean
      - `cannotAddUserReason` string, nullable
  - `_meta` object
    - `_credits` object
      - `used` integer
      - `balance` integer
      - `note` string
    - `_cache` object
      - `is_cached` boolean
      - `note` string
    - `_rate_limits` object
      - `limit_minute` integer
      - `limit_day` integer
      - `remaining_minute` integer
      - `remaining_day` integer

## Changes

- **2026-05-24** `93a6dfdeeb67` — 1 breaking, 2 info
  - the response property `data/userState/cannotAddUserReason` became nullable for the status `200`
  - api tag `User List Collections` added
  - api tag `Collections - User Lists` removed

[Change history](https://skmtc.dev/onlyfansapi/apis/onlyfans-api/changes/api/:account/user-lists/:userListId/users/:userId/delete.md)

---

[API](https://skmtc.dev/onlyfansapi/apis/onlyfans-api.md) · [All operations](https://skmtc.dev/onlyfansapi/apis/onlyfans-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/onlyfansapi/onlyfans-api/revisions/4a99d36f28a3/schema)