Remove a member

DELETE

/org-admin/{slug}/members/{userId}

Deactivates every org-scoped role the user holds on this organization. Only an org_owner may remove an owner, and nobody may remove a member whose role is equal to or above their own (403). Removing yourself (leaving) is always allowed. The organization's last remaining owner cannot be removed (400) — promote another member to owner first.

Requires permission: org.manage_members

Authorizations

BearerAuth

In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.

Type

HTTP (bearer)

Parameters

Path Parameters

slug*

The organization's slug (not its UUID).

Type

string

Required

Example"local-food-bank-a1b2c3"

Pattern

"^[a-z0-9][a-z0-9-]{0,254}$"

userId*

The member's profile id. A non-UUID answers 404 Member not found.

Type

string

Required

Format

"uuid"

Responses

Member removed

DELETE

/org-admin/{slug}/members/{userId}

Playground

Server

Authorization

BearerAuth

Variables

Key

Value

slug*

userId*

Samples

Powered by VitePress OpenAPI