DoloresDocs
API referenceCustomers

Delete a customer (soft)

Soft-deletes the customer. The row remains in the database but disappears from list and lookup results. Appointments and sessions tied to this customer are preserved.

DELETE
/customers/{id}

Authorization

AuthorizationRequiredBearer <token>

Send your API key in the Authorization header on every request: Authorization: Bearer sk_live_.... Keys are created in the admin UI under Settings → API Keys and are project-scoped.

In: header

Path Parameters

idRequiredstring

Customer ID (prefixed with cust_).

Response Body

Deleted.

TypeScript Definitions

Use the response body type in TypeScript.

idstring
objectstring
Value in: "customer"
deletedboolean

Resource not found.

TypeScript Definitions

Use the response body type in TypeScript.

errorRequiredobject
curl -X DELETE "https://app.meetdolores.ai/v1/customers/string" \
  -H "Authorization: Bearer <token>"
fetch("https://app.meetdolores.ai/v1/customers/string", {
  headers: {
    "Authorization": "Bearer <token>"
  }
})
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://app.meetdolores.ai/v1/customers/string"

  req, _ := http.NewRequest("DELETE", url, nil)
  req.Header.Add("Authorization", "Bearer <token>")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}
import requests

url = "https://app.meetdolores.ai/v1/customers/string"

response = requests.request("DELETE", url, headers = {
  "Authorization": "Bearer <token>"
})

print(response.text)
require 'net/http'
require 'json'
require 'uri'

uri = URI('https://app.meetdolores.ai/v1/customers/cust_01HXY...')
req = Net::HTTP::Delete.new(uri, {
  'Authorization' => "Bearer #{ENV['DOLORES_API_KEY']}",
})
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
puts res.body
<?php
$ch = curl_init('https://app.meetdolores.ai/v1/customers/cust_01HXY...');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'DELETE',
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('DOLORES_API_KEY'),
  ],
]);
echo curl_exec($ch);
{
  "id": "string",
  "object": "customer",
  "deleted": true
}
{
  "error": {
    "type": "invalid_request_error",
    "code": "phone_invalid_format",
    "message": "string",
    "param": "string",
    "request_id": "string"
  }
}