Remove workspace member

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Removes someone from a workspace.

Removing someone takes away their access to the workspace and its apps right away:

  • Apps they own move to the workspace owner, and their webhooks go to the owner too.
  • Their personal access tokens for the workspace are deleted, and integrations they connected in the workspace are disconnected.
  • They leave every custom group.
  • If this was the last workspace they could sign in to, their Base44 account is disabled.

Removing someone whose invitation is still pending cancels the invitation.

You can't remove yourself or the workspace owner. Retrying a removal that succeeded returns a 404.

This is limited to 30 requests per minute, shared with Update workspace member role, Remove workspace member, Set member credit limit, and Set default member credit limit. A signed-in session has its own limit, and every personal access token for the workspace shares one. Some workspaces have a different limit.

<Note>Call this as an owner or admin of the workspace, with a personal access token for that workspace sent as a Bearer token, or from a signed-in session. A read-only token is refused, and workspace API keys aren't accepted.</Note>

delete/api/workspace/members/{email}

Path parameters

emailstring required

Email of the member to remove, exactly as email in List workspace members returns it. Matching is exact, including case. URL-encode it: @ as %40 and + as %2B.

Email of the member to remove, exactly as email in List workspace members returns it. Matching is exact, including case. URL-encode it: @ as %40 and + as %2B.

Query parameters

workspaceIdstring required

ID of the workspace. With a personal access token, use the token's workspace. Get it from organization_id in Get app.

ID of the workspace. With a personal access token, use the token's workspace. Get it from organization_id in Get app.

Response

The person is no longer in the workspace.

status'success' required

Always success.

messagestring required

Short confirmation. Its wording can change, so don't parse it.

Example response

{
  "status": "success",
  "message": "Members added to group."
}

Changes

Changed in 1 of the 28 revisions of this API.1

Of the 28 revisions, 1 has no diff computed.