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.

DELETE /api/v1/vault/projects/{project_id}/users

Remove Project Users

cURL

curl --request DELETE \
  --url https://api.harvey.ai/api/v1/vault/projects/{project_id}/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "emails": [
    "[e-mail]"
  ]
}
'

200

{
  "data": {
    "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "removed": [
      "[e-mail]"
    ],
    "failed": [
      {
        "email": "[e-mail]",
        "reason": "<string>"
      }
    ]
  }
}

Permissions

Requires Vault API and Vault sharing permissions.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

project_id · string<uuid> · required

The unique identifier of the Vault project

Body

application/json

emails · string<email>[] · required

List of workspace user email addresses whose direct shares should be removed from the project

Response

200

application/json

Successfully processed removal request

status · enum<string> · required

Status of the request

Available options: COMPLETED

data · object · required

Show child attributes