Dispatch

Update a customer

PATCH/v1/dispatch/customers/:ref

Changes a customer's name or metadata.

Parameters

Path parameters1

refstringRequired

The customer's external_id or its cst_ ID.

Body parameters2

name?string

New name.

metadata?object

New metadata.

Returns

200The sample response is on the right.Errors return error and message; see Errors and limits.

PATCHUpdate a customer

curl -X PATCH "https://api.getensue.com/v1/dispatch/customers/acme" \
  -H "authorization: Bearer $ENSUE_API_KEY"

const res = await fetch("https://api.getensue.com/v1/dispatch/customers/acme", {
  method: "PATCH",
  headers: {
    authorization: `Bearer ${process.env.ENSUE_API_KEY}`,
  },
});
console.log(await res.json());

import os, requests

res = requests.patch(
    "https://api.getensue.com/v1/dispatch/customers/acme",
    headers={"authorization": f"Bearer {os.environ['ENSUE_API_KEY']}"},
)
print(res.json())

200Response

{
  "id": "cst_4h6w…",
  "external_id": "acme",
  "name": "Acme Inc",
  "metadata": {},
  "created": 1762761600000,
  "updated": 1762761600000
}

{"id":"cst_4h6w…","external_id":"acme","name":"Acme Inc","metadata":{},"created":1762761600000,"updated":1762761600000}