---
title: "Remove Group Member Access"
method: DELETE
path: "/api/v1/groups/{group_id}/members/{user_id}"
tags: ["Team Management"]
---

# Remove Group Member Access

`DELETE /api/v1/groups/{group_id}/members/{user_id}`

## Request

- Base URL: `https://api.athenahq.ai`
- URL: `https://api.athenahq.ai/api/v1/groups/{group_id}/members/{user_id}`
- Auth: API key in header `x-api-key`

Removes a user's direct group membership and their explicit website memberships for websites currently in the group. Both sets of rows are removed atomically. The request is idempotent: a retry, or a well-formed user ID with no matching membership rows, returns `200` with `group_membership_removed: false` and `website_memberships_removed: 0`.

Organization membership, membership in other groups, and website membership outside this group are preserved. If another group grants access to one of the same websites, that effective access remains through the other group even though the user's explicit website membership row is removed. Organization members return `409` because their organization-derived access would remain. Requires a global API key, and the API key's own user cannot be removed. The endpoint accepts no request body.

## Response `200`

Group-scoped membership removal completed

- object
  - `success` true, required
  - `group_membership_removed` boolean, required: Whether a direct group membership row was removed
  - `website_memberships_removed` integer, required: Number of explicit website membership rows removed for websites currently in the group

## Other responses

- `400`: Bad request - Invalid group or user ID
- `401`: Unauthorized - Invalid or missing API key
- `403`: Forbidden - Not a global API key, or attempted self-removal
- `404`: Not found - Group does not exist in your organization
- `409`: Conflict - The target is an organization member whose organization-derived access would remain
- `500`: Internal server error

## Changes

- **2026-11-03** `2d1d86d5e067`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/athenahq/apis/athenahq-api/changes/api/v1/groups/:group_id/members/:user_id/delete.md)

---

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