> ## 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.

# Remove collaborator

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

Takes away a collaborator's access to edit the app in Base44. Only the app owner can do this, and the owner can't be removed.

By default the person stays a user of the app with the role they had, so they can still sign in to it. Set `also_remove_from_app` to `true` to remove them from the app's users as well; on a workflow project they are always removed, since a project's only users are its editors. If they connected the app to Google Business Profile or Plaid, those connections are disconnected.

A collaborator whose `collaborator_source` is `workspace` joined because the app is open to everyone in its workspace, so they can join again the next time they open it while it stays open.

This is limited to 60 requests per minute per app for each workspace's personal API keys, so every personal API key in a workspace shares one allowance, and each workspace API key has its own. List collaborators and Remove collaborator share it. Some workspaces have a different limit.

<Note>This endpoint accepts a personal API key belonging to the app owner. A workspace API key for the app's workspace also works when the workspace owner owns the app, since the key acts as the workspace owner. A read-only token or key is refused.</Note>



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json delete /api/apps/{app_id}/users/collaborators/{collaborator_id}
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - PersonalAccessTokenAuth: []
paths:
  /api/apps/{app_id}/users/collaborators/{collaborator_id}:
    delete:
      summary: Remove collaborator
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Takes away a collaborator's access to edit the app in Base44. Only the
        app owner can do this, and the owner can't be removed.


        By default the person stays a user of the app with the role they had, so
        they can still sign in to it. Set `also_remove_from_app` to `true` to
        remove them from the app's users as well; on a workflow project they are
        always removed, since a project's only users are its editors. If they
        connected the app to Google Business Profile or Plaid, those connections
        are disconnected.


        A collaborator whose `collaborator_source` is `workspace` joined because
        the app is open to everyone in its workspace, so they can join again the
        next time they open it while it stays open.


        This is limited to 60 requests per minute per app for each workspace's
        personal API keys, so every personal API key in a workspace shares one
        allowance, and each workspace API key has its own. List collaborators
        and Remove collaborator share it. Some workspaces have a different
        limit.


        <Note>This endpoint accepts a personal API key belonging to the app
        owner. A workspace API key for the app's workspace also works when the
        workspace owner owns the app, since the key acts as the workspace owner.
        A read-only token or key is refused.</Note>
      operationId: >-
        remove_collaborator_api_apps__app_id__users_collaborators__collaborator_id__delete
      parameters:
        - name: collaborator_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              ID of the collaborator, as returned by [List
              collaborators](/api-reference/list-collaborators).
            title: Collaborator Id
          description: >-
            ID of the collaborator, as returned by [List
            collaborators](/api-reference/list-collaborators).
          example: 68b2d4f6a8c0e2f4a6b8c0d2
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            description: ID of the app to remove the collaborator from.
            title: App Id
          description: ID of the app to remove the collaborator from.
          example: 6820f3a4e7b91d003c45a1f2
        - name: also_remove_from_app
          in: query
          required: false
          schema:
            type: boolean
            description: >-
              Set to `true` to also remove the person from the app's users, not
              just its collaborators.
            default: false
            title: Also Remove From App
          description: >-
            Set to `true` to also remove the person from the app's users, not
            just its collaborators.
          example: false
      responses:
        '200':
          description: The collaborator was removed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RemoveCollaboratorResult'
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            You aren't the app owner (with a workspace API key, the workspace
            owner doesn't own the app), `collaborator_id` is the owner's, the
            app is blocked, or your API key is read-only.
        '404':
          description: App not found, or the app has no user with this `collaborator_id`.
        '409':
          description: >-
            The collaborator is creating a Google Business Profile for the app.
            Try again once that finishes.
        '422':
          description: '`also_remove_from_app` isn''t a boolean.'
        '429':
          description: >-
            Rate limit exceeded. The base limit is 60 requests per minute. See
            [Rate
            limits](/developers/references/apps-api/get-started/rate-limits) for
            the multiplier your plan gets.
        '503':
          description: >-
            Database temporarily unavailable (`database_unavailable`): the data
            cluster did not answer in time. Retry after the `Retry-After`
            seconds.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorEnvelope'
              examples:
                database_unavailable:
                  summary: database_unavailable
                  value:
                    error:
                      code: database_unavailable
                      message: Database temporarily unavailable, please retry
                      details: {}
      security:
        - PersonalAccessTokenAuth:
            - full_access
        - WorkspaceApiKeyAuth:
            - full_access
        - WorkspaceApiKeyBearerAuth:
            - full_access
components:
  schemas:
    RemoveCollaboratorResult:
      properties:
        success:
          type: boolean
          title: Success
          description: Always `true`.
          example: true
      type: object
      required:
        - success
      title: RemoveCollaboratorResult
      description: The result of removing a collaborator.
    StandardErrorEnvelope:
      properties:
        error:
          $ref: '#/components/schemas/StandardError'
          description: What went wrong.
      type: object
      required:
        - error
      title: StandardErrorEnvelope
      description: The error body returned in the standard envelope.
    StandardError:
      properties:
        code:
          type: string
          title: Code
          description: >-
            Stable machine-readable cause of the failure. Match on this, not on
            `message`.
          example: not_found
        message:
          type: string
          title: Message
          description: Human-readable explanation. It isn't a stable contract.
          example: App not found
        details:
          additionalProperties: true
          type: object
          title: Details
          description: >-
            Structured context for the failure, or an empty object when there's
            none.
          example: {}
      type: object
      required:
        - code
        - message
      title: StandardError
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: >-
        Personal access token, sent as `Authorization: Bearer <token>`. Each
        operation lists the permission it needs: `read_only` or `full_access`. A
        full-access token can call every operation. A read-only token can call
        only the operations that list `read_only`; anything else returns 403
        `read_only_credential_route_not_allowed`.
    WorkspaceApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: >-
        Workspace API key, sent as `api_key: <key>`. Each operation that accepts
        one lists what the key needs: a permission, `read_only` or
        `full_access`, like a personal access token, or a scope. A key without
        the scope gets 403 `workspace_api_key_scope_required`.
    WorkspaceApiKeyBearerAuth:
      type: http
      scheme: bearer
      description: >-
        Workspace API key, sent as `Authorization: Bearer <key>`. Accepted
        wherever `api_key` is, with the same permission.

````

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