---
title: "Remove Folders for User"
method: POST
path: "/users/folders/remove"
tags: ["User Management"]
---

# Remove Folders for User

`POST /users/folders/remove`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/users/folders/remove`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/users/folders/remove/post.ts> (a function with typed inputs; its response is checked against the schema)

This API removes specific locations associated with a user, revoking their access to those locations.

Behavior:
- Supports removing one or multiple locations from a user.
- Updates the user’s permissions and access scope accordingly.

## Headers

- `Authorization` string

## Request body

- object
  - `input` object, required
    - `userId` string, required: Base64 encoded user ID
    - `folderIds` string[], required: Array of folder UUIDs to remove for the user

## Response `200`

Successfully removed folders for user

- object
  - `data` object
    - `removeFoldersForUser` object
      - `status` object[]
        - `errors` string[], nullable: Array of error messages if any
        - `folderId` string, uuid: UUID of the folder being removed
        - `success` boolean: Whether the folder was successfully removed

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)