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

# Remove Project Users

> Removes direct workspace user shares for specified users (identified by email address) from a Vault project. Only direct `WORKSPACE_USER` shares are removed; inherited access via workspace, group, or space shares is not affected. Per-user validation failures (e.g. unknown email, inactive user, project owner, self-removal) are returned in the `failed` list rather than rejecting the entire request.

Requires vault sharing to be enabled.

### Permissions

Requires `Vault API` and `Vault sharing` permissions.


## OpenAPI

````yaml /vault_api.json delete /api/v1/vault/projects/{project_id}/users
openapi: 3.0.1
info:
  title: Vault - Upload Documents
  description: >-
    The Vault Upload Documents API enables users to programmatically upload and
    manage documents within Vault projects. This API allows organizations to
    maintain projects with their own internal files for their users to use
    within the Harvey app.
  version: 1.0.0
  contact:
    email: support@harvey.ai
servers:
  - url: https://api.harvey.ai
    description: Harvey API server
security: []
paths:
  /api/v1/vault/projects/{project_id}/users:
    delete:
      tags:
        - Vault
      summary: Remove Project Users
      description: >-
        Removes direct workspace user shares for specified users (identified by
        email address) from a Vault project. Only direct `WORKSPACE_USER` shares
        are removed; inherited access via workspace, group, or space shares is
        not affected. Per-user validation failures (e.g. unknown email, inactive
        user, project owner, self-removal) are returned in the `failed` list
        rather than rejecting the entire request.


        Requires vault sharing to be enabled.
      operationId: removeProjectUsers
      parameters:
        - name: project_id
          in: path
          required: true
          description: The unique identifier of the Vault project
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                emails:
                  type: array
                  items:
                    type: string
                    format: email
                  description: >-
                    List of workspace user email addresses whose direct shares
                    should be removed from the project
              required:
                - emails
      responses:
        '200':
          description: Successfully processed removal request
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - COMPLETED
                    description: Status of the request
                  data:
                    type: object
                    properties:
                      project_id:
                        type: string
                        format: uuid
                        description: The project ID
                      removed:
                        type: array
                        description: >-
                          Email addresses of users whose direct shares were
                          successfully removed
                        items:
                          type: string
                          format: email
                      failed:
                        type: array
                        description: >-
                          Users whose share removal failed, with per-user
                          reasons
                        items:
                          type: object
                          properties:
                            email:
                              type: string
                              format: email
                              description: The email address that failed
                            reason:
                              type: string
                              description: >-
                                Why the removal failed (e.g. "User not found",
                                "Cannot remove project owner", "Duplicate email
                                in request")
                          required:
                            - email
                            - reason
                    required:
                      - project_id
                      - removed
                      - failed
                required:
                  - status
                  - data
        '400':
          description: >-
            Bad request - malformed request body (e.g. missing required fields,
            invalid JSON)
        '401':
          description: Unauthorized - Invalid or missing API token
        '403':
          description: >-
            Forbidden - User lacks required permissions, vault sharing is
            disabled, or project access is denied
        '404':
          description: Project not found
        '429':
          description: Rate limit exceeded
        '500':
          description: Internal server error
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````