Update a customer

Updates an existing customer’s information.

This endpoint allows you to modify customer details while preserving their core information.

Use Cases

• Update customer contact information
• Change customer type
• Modify customer status

Path Parameters

• id: Customer UUID (required) - Must be a valid UUID format

Example Request

PATCH /api/v0/customers/123e4567-e89b-12d3-a456-426614174000

Example Request Body

{
  "first_name": "John",
  "last_name": "Smith",
  "phone_number": "[phone]",
  "customer_type": "Small Business"
}

Notes

• Only include fields that need to be updated
• All fields are optional in updates
• Status changes may require additional verification

PATCH /api/v0/customers/{id}

Update a customer

cURL

curl --request PATCH \
  --url https://api.devdraft.ai/api/v0/customers/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-client-secret: <api-key>' \
  --data '
{
  "first_name": "John",
  "last_name": "Doe",
  "email": "[e-mail]",
  "phone_number": "[phone]",
  "customer_type": "Individual",
  "status": "ACTIVE"
}
'

Authorizations

x-client-secretx-client-key

x-client-secret · string · header · required

Your secret API key. Keep this secure and never expose it in client-side code.

Path Parameters

id · string<uuid> · required

Customer unique identifier (UUID)

Example:

"cust_123e4567-e89b-12d3-a456-426614174000"

Body

application/json

Customer update data

first_name · string

Customer's first name. Used for personalization and legal documentation.

Required string length: 1 - 100

Example:

"John"

last_name · string

Customer's last name. Used for personalization and legal documentation.

Required string length: 1 - 100

Example:

"Doe"

email · string<email>

Customer's email address. Used for notifications, receipts, and account management. Must be a valid email format.

Example:

"[e-mail]"

phone_number · string

Customer's phone number. Used for SMS notifications and verification. Include country code for international numbers.

Pattern: ^[+]?[1-9]\d{1,14}$

Example:

"[phone]"

customer_type · enum<string> · default: Individual

Type of customer account. Determines available features and compliance requirements.

Available options: Individual, Startup, Small Business, Medium Business, Enterprise, Non-Profit, Government

Example:

"Individual"

status · enum<string> · default: ACTIVE

Current status of the customer account. Controls access to services and features.

Available options: ACTIVE, BLACKLISTED, DEACTIVATED, DELETED

Example:

"ACTIVE"

Response

200

Successfully updated customer