---
title: "Remove someone from an app"
description: "Takes away access to this app only."
canonical: "https://gtable.app/docs/builder-api/members/remove"
updated: "2026-10-05"
---

# Remove someone from an app

`DELETE https://studio.gtable.app/v1/apps/{appId}/members/{userId}`

Takes away access to this app only.

They stay in the directory and keep every other app they are in, and the records they created stay, those belong to the app.

Requires the `members:write` scope. Operation `members.remove`. MCP tool `members_remove`. CLI, once published: `gtable members remove`.

## Path parameters

| Name     | Type   | Required | Description |
| -------- | ------ | -------- | ----------- |
| `appId`  | string | yes      |             |
| `userId` | string | yes      |             |

## Headers

| Name              | Type   | Required | Description                                                                                                                                                                                                                                                        |
| ----------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Idempotency-Key` | string | no       | Any unique string. Sending the same key with the same request again returns the first response (marked `Idempotency-Replayed: true`) instead of running it twice. Reusing it for a different request is refused with 409. Kept for 24 hours. Up to 255 characters. |