---
title: "Leave a workspace the authenticated user belongs to"
method: DELETE
path: "/v2/workspaces/leave"
tags: ["Workspaces"]
---

# Leave a workspace the authenticated user belongs to

`DELETE /v2/workspaces/leave`

Removes the authenticated user from the workspace's member list. The owner cannot leave their own workspace — use `DELETE /v2/workspaces` to delete it instead.

Rate limited to 1 leave every 5 seconds per user.

## Request body

- object
  - `workspaceId` string, required

## Response `200`

Membership removed.

- object
  - `status` 'success', required

## Other responses

- `400` — The `workspaceId` is missing or the caller is the workspace owner.
- `401` — The Authorization header is missing, malformed, or the credentials are not valid.
- `404` — The workspace does not exist or the caller is not a member.
- `413` — The request body is larger than the maximum allowed size (100MB).
- `429` — The endpoint enforces its own rate limit and the caller hit the cooldown.
- `500` — An unexpected error occurred while processing the request.

---

[API](https://skmtc.dev/squarecloud/apis/square-cloud-api.md) · [All operations](https://skmtc.dev/squarecloud/apis/square-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/squarecloud/square-cloud-api/revisions/54b7733a6b95/schema)
