Delete Case

Delete an existing Monolith Case by UUID, including associated dependent records.

The Delete Case endpoint deletes an existing Case identified by its UUID.

Deleting a Case also deletes associated dependent records, including related Evidence, Tasks, Notes, report data, and other dependent Case records.

Deleting a Case is a destructive operation. Confirm that you are targeting the correct Case before sending the request.

DELETE /api/v1/cases/:uuid

All requests require a valid API key in the X-API-KEY request header.

See Authentication for additional API authentication guidance.

Name

Type

Required

Description

uuid

string

Yes

UUID of the Case to delete.

This endpoint does not accept query parameters.

Any query string parameter returns an HTTP 400 response.

A successfully deleted Case returns an HTTP 200 response.

{
  "message": "Case Deleted",
  "case_id": 123,
  "case_number": "INV-2026-001",
  "case_ref": "Customer Investigation",
  "uuid": "abc123..."
}

The response includes identifying information for the Case that was deleted.

A request without the required UUID returns an HTTP 400 response.

{
  "message": "Invalid case data",
  "success": false,
  "errors": [
    {
      "message": "\"uuid\" is required"
    }
  ]
}

If the supplied UUID does not resolve to an existing Case, the API returns an HTTP 400 response.

{
  "message": "Case not found",
  "success": false
}

The following example deletes a Case identified by UUID.

curl -X DELETE "<api-base-url>/cases/<case-uuid>" \
  -H "X-API-KEY: <api-key>"

Replace <api-base-url> with the /api/v1 base URL for your Monolith environment and <case-uuid> with the UUID of the Case you want to delete.

See API Endpoints for the correct API base URL.

Last updated 16 days ago

Was this helpful?