curl --request DELETE \
--url https://app.thinnest.ai/api/v1/customers/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/customers/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/customers/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text){
"id": "org_5b2f9c1e-8a4d-4f7b-9e3a-2c6d1f0a7b84",
"name": "Sunrise Dental Clinic",
"externalId": "clinic-0042",
"metadata": {
"city": "Pune",
"tier": "gold",
"seats": 3
},
"timezone": "Asia/Kolkata",
"allottedCallLines": 2,
"archivedAt": "2026-10-06T10:05:41.203Z",
"eraseAfter": "2026-11-05T10:05:41.203Z",
"createdAt": "2026-10-02T06:14:22.418Z"
}{
"error": "Manage customers without the Thinnest-Workspace header: they belong to your own workspace."
}{
"error": "Send a valid API key as `Authorization: Bearer <key>`."
}{
"error": "This API key is read-only: it can read everything but change nothing."
}{
"error": "Customer not found."
}{
"error": "This customer still holds phone number +918041234567. Release it first: that is permanent, so it is never done as a side effect of deleting."
}{
"error": "Over 240 requests a minute. Slow down and retry."
}Delete Customer
Deletes a customer: requests into it answer 410 from now on, every key made for it is revoked, its webhooks are switched off, its campaigns cancelled and its sequences and scheduled callbacks stopped (a call already in progress finishes). 30 days later it is erased — every conversation, contact, recording and file — unless you restore it first. Refused while the customer still holds a rented phone number or a connected WhatsApp number: release those yourself first, because that cannot be undone. Deleting an already-deleted customer answers it as it is. Needs a full key.
curl --request DELETE \
--url https://app.thinnest.ai/api/v1/customers/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/customers/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/customers/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text){
"id": "org_5b2f9c1e-8a4d-4f7b-9e3a-2c6d1f0a7b84",
"name": "Sunrise Dental Clinic",
"externalId": "clinic-0042",
"metadata": {
"city": "Pune",
"tier": "gold",
"seats": 3
},
"timezone": "Asia/Kolkata",
"allottedCallLines": 2,
"archivedAt": "2026-10-06T10:05:41.203Z",
"eraseAfter": "2026-11-05T10:05:41.203Z",
"createdAt": "2026-10-02T06:14:22.418Z"
}{
"error": "Manage customers without the Thinnest-Workspace header: they belong to your own workspace."
}{
"error": "Send a valid API key as `Authorization: Bearer <key>`."
}{
"error": "This API key is read-only: it can read everything but change nothing."
}{
"error": "Customer not found."
}{
"error": "This customer still holds phone number +918041234567. Release it first: that is permanent, so it is never done as a side effect of deleting."
}{
"error": "Over 240 requests a minute. Slow down and retry."
}Authorizations
Your API key (ta_live_…) from Settings → API keys, sent as Authorization: Bearer <key>. Keep it on a server: it can message every customer you have. A key is full, build or read-only; a request its level does not allow is refused with 403.
Path Parameters
The customer's id (org_…), as Create Customer answered.
Response
The customer, now deleted, with the date it will be erased.
A workspace you created for one of your customers.
The customer's id (org_…). Send it as Thinnest-Workspace to act inside this customer.
"org_5b2f9c1e-8a4d-4f7b-9e3a-2c6d1f0a7b84"
The customer's name.
120"Sunrise Dental Clinic"
Your own id for this customer, unique among your customers; null when you gave none.
"clinic-0042"
Your own flat key-value data about the customer: up to 50 keys of 1-40 characters, each value a string (up to 500 characters), a number or a boolean. No nested objects or lists; 8 KB in all.
Show child attributes
Show child attributes
{
"city": "Pune",
"tier": "gold",
"seats": 3
}
The customer's IANA time zone; every date its console shows is in it.
"Asia/Kolkata"
How many of your call lines this customer may use at once; null for no cap.
x >= 02
When the customer was deleted; null while it is live.
null
When a deleted customer will be erased for good (30 days after deletion); null while it is live.
null
When the customer was created.
"2026-10-02T06:14:22.418Z"