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

# Deprovision an app user

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

Removes a person's access to this app, including their app user if they've already signed in. A workspace API key needs the **Provision app users** permission. Limited to 120 requests a minute per app, shared with provisioning. Higher plans get a higher limit.



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json delete /api/apps/{app_id}/users/provisions
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/provisions:
    delete:
      summary: Deprovision an app user
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Removes a person's access to this app, including their app user if
        they've already signed in. A workspace API key needs the **Provision app
        users** permission. Limited to 120 requests a minute per app, shared
        with provisioning. Higher plans get a higher limit.
      operationId: deprovision_user_api_apps__app_id__users_provisions_delete
      parameters:
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            description: ID of the app.
            title: App Id
          description: ID of the app.
          example: 6820f3a4e7b91d003c45a1f2
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeprovisionUserPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeprovisionUserResponse'
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            The email belongs to the app's owner or to someone with
            platform-level access: error.code privileged_user.
        '404':
          description: 'The email isn''t provisioned for this app: error.code unknown_user.'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '429':
          description: >-
            The app went over its per-minute limit for provision and deprovision
            requests combined.
      security:
        - PersonalAccessTokenAuth: []
        - WorkspaceApiKeyAuth: []
components:
  schemas:
    DeprovisionUserPayload:
      properties:
        email:
          type: string
          format: email
          title: Email
          description: The app user's email
      additionalProperties: false
      type: object
      required:
        - email
      title: DeprovisionUserPayload
      description: >-
        Payload for server-to-server app-user deprovisioning (embedded
        platforms).


        The email travels in the body, not the path: a URL reaches access logs,

        proxies and traces, and an address is personal data.
    DeprovisionUserResponse:
      properties:
        status:
          type: string
          const: deleted
          title: Status
          description: Always `deleted`.
          example: deleted
        email:
          type: string
          title: Email
          description: The email, lowercased.
          example: dana@example.com
      type: object
      required:
        - status
        - email
      title: DeprovisionUserResponse
      description: The app user whose access was removed.
    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>`.'
    WorkspaceApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: 'Workspace API key, sent as `api_key: <key>`.'

````