Skip to main content
DELETE
Delete Matters

Permissions

Requires Client matters admin (write:client_matters).

Matching

Send the client_id and matter_id you use with POST /api/v2/matters. Do not send the full matter name or harvey_id. Harvey trims leading and trailing whitespace from both identifiers. Matching uses the identifier pair first, then the stored name: client_id + the delimiter + matter_id. This finds matters created through v1. Deleted matters also match. The API uses the delimiter configured for the token’s active workspace, or . when it is unset or blank. This endpoint never returns delimiter_required, and the workspace’s name format does not apply.

Results

Each pair appears once in the response: in deleted, already_absent, or errors. deleted and already_absent return the trimmed identifiers. errors echoes the values you sent. A pair with no matching matter, including a pair whose client does not exist, appears in already_absent. So does a matter that was already deleted. These are successful results, so a repeated request is safe. A pair that repeats an earlier pair after trimming fails with duplicate_pair; Harvey processes the earlier pair as usual. Externally linked matters, such as matters synced from a DMS or an ethical-wall provider, fail with blocked_by_ethical_wall while ethical-wall enforcement is enabled for the workspace. Deleting a matter keeps its parent client and its ethical-wall configuration. A later POST /api/v2/matters with the same pair restores the matter. See the Client Matters guide for examples and error handling.

Authorizations

Authorization
string
header
required

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

Body

application/json

Submit explicit client_id and matter_id pairs. Unknown fields return HTTP 400 with invalid_request.

matters
object[]
required
Required array length: 1 - 10000 elements

Response

Per-pair results for the submitted matters.

deleted
object[]
required

Matters deleted by this request.

already_absent
object[]
required

Missing or already-deleted matters. These are successful results.

errors
object[]
required