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

# Remove Locations for User

`POST /users/locations/remove`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/users/locations/remove`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/users/locations/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
    - `locationIds` string[], required

## Response `200`

Successfully removed locations for user

- object
  - `data` object
    - `removeLocationsForUser` object
      - `status` object[]
        - `errors` string[], nullable: Array of error messages if any
        - `locationId` string: Base64 encoded location ID that was removed
        - `success` boolean: Whether the location 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)