> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Remove a workspace member

> Remove a member from a workspace with DELETE /v2/workspaces/members, revoking their access to every shared application at once. Only the owner can.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  The API key for your account. You can find this in your [account settings](https://squarecloud.app/en/account/security).
</ParamField>

Requires an API key with the `workspaces:manage` [scope](/en/api-reference/authentication#scopes).

Removes a member from a workspace, immediately revoking their access to every application shared into it. Only the workspace owner can call this endpoint; a member who wants to remove themselves should use [Leave Workspace](/en/api-reference/endpoint/workspace/leave) instead.

Removing a member does not free up their invite code for reuse: generate a fresh one with [Get Invite Code](/en/api-reference/endpoint/workspace/members/code) if they need to rejoin later. Rate limited to 5 removals per 30 seconds per user.

## Parameters

<ParamField body="workspaceId" type="string" placeholder="Workspace Id" required>
  The ID of the workspace.
</ParamField>

<ParamField body="memberId" type="string" placeholder="Member ID" required>
  The member ID.
</ParamField>

## Response

<ResponseField name="status" type="string">
  Indicates whether the call was successful: `success` if it was, `error` if not.
</ResponseField>

<ResponseExample>
  ```json theme={"system"}
  {
    "status": "success"
  }
  ```
</ResponseExample>

## Common errors

| Code | HTTP | Meaning |
| - | - | - |
| `INVALID_ID` | 400 | `workspaceId` is missing. |
| `MEMBER_NOT_FOUND` | 400 | `memberId` is missing. |
| `MEMBER_NOT_FOUND` | 404 | The member is no longer in the workspace (already removed). |

## Related

* CLI: [`squarecloud workspace member remove`](/en/cli-reference/workspace-members#squarecloud-workspace-member-remove)
* SDKs: [`api.workspaces.members.remove()`](/en/sdks/js/workspaces) (JavaScript), [`client.workspaces.members.remove()`](/en/sdks/py/workspaces) (Python), [`c.Workspaces.Members.Remove()`](/en/sdks/go/workspaces) (Go)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.