---
title: "Delete a client"
method: DELETE
path: "/clients/{id}"
tags: ["Clients"]
---

# Delete a client

`DELETE /clients/{id}`

## Request

- Base URL: `https://api.soraban.com`
- URL: `https://api.soraban.com/clients/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/soraban/apis/soraban-private-api/docs/clients/:id/delete.ts> (a function with typed inputs; its response is checked against the schema)

Requires a key with the `write_enhanced` scope.

By default this is a soft delete and the client can be restored in Soraban. Passing `hardDelete=true` permanently destroys the client and their entities, which cannot be undone.

A client shared with another firm cannot be deleted through the API.

## Query parameters

- `hardDelete` boolean

## Response `200`

Success.

- Message
  - `message` string

## Other responses

- `403`: The key lacks the `write_enhanced` scope, or the record does not belong to your firm.
- `422`: The request was understood but rejected. See `error` for the reason.

---

[API](https://skmtc.dev/soraban/apis/soraban-private-api.md) - [All operations](https://skmtc.dev/soraban/apis/soraban-private-api/llms.txt) - [OpenAPI document](https://skmtc.dev/soraban/apis/soraban-private-api/revisions/1c230fa547ad?raw)