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

> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.

# 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](/api-reference/update-workspace-member-role), [Remove workspace member](/api-reference/remove-workspace-member), [Set member credit limit](/api-reference/set-member-credit-limit), and [Set default member credit limit](/api-reference/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>



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json delete /api/workspace/members/{email}
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - PersonalAccessTokenAuth: []
paths:
  /api/workspace/members/{email}:
    delete:
      summary: Remove workspace member
      description: >-
        <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](/api-reference/update-workspace-member-role), [Remove
        workspace member](/api-reference/remove-workspace-member), [Set member
        credit limit](/api-reference/set-member-credit-limit), and [Set default
        member credit limit](/api-reference/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>
      operationId: remove_member_api_workspace_members__email__delete
      parameters:
        - name: email
          in: path
          required: true
          schema:
            type: string
            description: >-
              Email of the member to remove, exactly as `email` in [List
              workspace members](/api-reference/list-workspace-members) returns
              it. Matching is exact, including case. URL-encode it: `@` as `%40`
              and `+` as `%2B`.
            title: Email
          description: >-
            Email of the member to remove, exactly as `email` in [List workspace
            members](/api-reference/list-workspace-members) returns it. Matching
            is exact, including case. URL-encode it: `@` as `%40` and `+` as
            `%2B`.
          example: dana@acme.com
        - name: workspaceId
          in: query
          required: true
          schema:
            type: string
            minLength: 1
            description: >-
              ID of the workspace. With a personal access token, use the token's
              workspace. Get it from `organization_id` in [Get
              app](/api-reference/get-app).
            title: Workspaceid
          description: >-
            ID of the workspace. With a personal access token, use the token's
            workspace. Get it from `organization_id` in [Get
            app](/api-reference/get-app).
          example: 67e0b12c4d8a3f005b21c9e4
      responses:
        '200':
          description: The person is no longer in the workspace.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChangeResult'
              example:
                status: success
                message: Member removed successfully.
        '400':
          description: You tried to remove yourself.
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            You aren't an owner or admin of the workspace, your token is for a
            different workspace or is read-only, your credential can't be used
            on this endpoint, or the person is the workspace owner.
        '404':
          description: No member or pending invitation with this email in the workspace.
        '409':
          description: >-
            Your workspace requires an unlocked SSO session, or an app the
            person owns can't move to the owner right now: an ownership transfer
            is being accepted, a Google Business profile is being created, or
            the workspace has no active owner.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '429':
          description: Rate limit exceeded.
components:
  schemas:
    ChangeResult:
      properties:
        status:
          type: string
          const: success
          title: Status
          description: Always `success`.
          example: success
        message:
          type: string
          title: Message
          description: Short confirmation. Its wording can change, so don't parse it.
          example: Members added to group.
      type: object
      required:
        - status
        - message
      title: ChangeResult
      description: Confirms the change.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: 'Personal access token, sent as `Authorization: Bearer <token>`.'

````

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