Skip to main content
PUT
/
admin
/
customers
/
{customer_id}
Update Customer
curl --request PUT \
  --url https://api.example.com/admin/customers/{customer_id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "company_name": "<string>",
  "contact_email": "<string>",
  "tier": "<string>",
  "status": "<string>",
  "contract_start": "<string>",
  "contract_end": "<string>",
  "metadata": {}
}
'
{
  "customer_id": "550e8400-e29b-41d4-a716-446655440000",
  "company_name": "Acme Financial",
  "contact_email": "compliance@acmefinancial.com",
  "tier": "scale",
  "status": "active",
  "annual_commitment": 500000,
  "annual_validation_limit": 30000000,
  "updated_at": "2026-01-20T15:00:00Z"
}
Update customer information including tier, status, and contract details.

​
Path Parameters

​
customer_id
string
required
Customer UUID

​
Request Body

All fields are optional. Only provided fields will be updated.
​
company_name
string
Updated company name
​
contact_email
string
Updated contact email
​
tier
string
New pricing tier: starter, growth, scale, enterprise, custom
​
status
string
Account status: active, suspended
​
contract_start
string
Contract start date (ISO 8601)
​
contract_end
string
Contract end date (ISO 8601)
​
metadata
object
Additional metadata
Tier changes take effect immediately. Rate limits will be updated to match the new tier.

​
Response

Returns the updated customer object. 
{
  "customer_id": "550e8400-e29b-41d4-a716-446655440000",
  "company_name": "Acme Financial",
  "contact_email": "compliance@acmefinancial.com",
  "tier": "scale",
  "status": "active",
  "annual_commitment": 500000,
  "annual_validation_limit": 30000000,
  "updated_at": "2026-01-20T15:00:00Z"
}

​
Example: Upgrade Tier

curl -X PUT "https://{admin-api-url}/admin/customers/550e8400-e29b-41d4-a716-446655440000" \
  -H "x-api-key: ADMIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tier": "scale"}'

​
Example: Suspend Customer

curl -X PUT "https://{admin-api-url}/admin/customers/550e8400-e29b-41d4-a716-446655440000" \
  -H "x-api-key: ADMIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "suspended"}'

​
Example: Reactivate Customer

curl -X PUT "https://{admin-api-url}/admin/customers/550e8400-e29b-41d4-a716-446655440000" \
  -H "x-api-key: ADMIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "active"}'