Update a customer

PATCH/v1/express/{expressCustomerId}

Updates a customer’s properties such as name or other metadata. All fields are optional - only provided fields will be updated.

Path ParametersExpand Collapse

expressCustomerId: string

Unique Express customer identifier. Format: cus_{32-hex-chars}

Body ParametersJSONExpand Collapse

expressCustomerName: optional string

Updated name for the Express customer

minLength1

metadata: optional map[string]

Updated metadata. Pass null to clear all metadata

ReturnsExpand Collapse

createdAt: string

Timestamp when the Express customer was created

formatdate-time

expressCustomerId: string

Unique Express customer identifier. Format: cus_{32-hex-chars}

expressCustomerName: string

Name of the Express customer

minLength1

isActive: boolean

Whether the Express customer is currently active

updatedAt: string

Timestamp when the Express customer was last updated

formatdate-time

userCount: number

Number of users currently in this Express customer

minimum0

createdByApiKeyId: optional string

UUID of the API key used to create this Express customer, for audit tracking

formatuuid

createdByUserId: optional string

User ID who created this Express customer via dashboard, null if created via API key

metadata: optional map[string]

Custom key-value metadata for the Express customer. Maximum 50 pairs, keys up to 100 chars, values up to 1000 chars

Update a customer

curl https://api.avarasoftware.com/v1/express/$EXPRESS_CUSTOMER_ID \
    -X PATCH \
    -H "Authorization: Bearer $AVARA_API_KEY"

{
  "createdAt": "2024-01-15T09:00:00Z",
  "expressCustomerId": "cus_1234567890abcdef1234567890abcdef",
  "expressCustomerName": "City Medical Center - Radiology Department",
  "isActive": true,
  "updatedAt": "2024-03-15T14:20:00Z",
  "userCount": 15,
  "createdByApiKeyId": "550e8400-e29b-41d4-a716-446655440000",
  "createdByUserId": "usr_1234567890abcdef1234567890abcdef",
  "metadata": {
    "department": "radiology",
    "region": "northeast"
  }
}

Returns Examples

{
  "createdAt": "2024-01-15T09:00:00Z",
  "expressCustomerId": "cus_1234567890abcdef1234567890abcdef",
  "expressCustomerName": "City Medical Center - Radiology Department",
  "isActive": true,
  "updatedAt": "2024-03-15T14:20:00Z",
  "userCount": 15,
  "createdByApiKeyId": "550e8400-e29b-41d4-a716-446655440000",
  "createdByUserId": "usr_1234567890abcdef1234567890abcdef",
  "metadata": {
    "department": "radiology",
    "region": "northeast"
  }
}