Skip to main content
PATCH
Update a client

Authorizations

x-api-key
string
header
required

Send the API key in the x-api-key header.

Path Parameters

id
string
required
Pattern: ^ovcid-.*$
Example:

"ovcid-22222222-2222-4222-8222-222222222222"

Body

application/json
firstName
string
Minimum string length: 1
Example:

"Sam"

lastName
string
Minimum string length: 1
Example:

"Client"

marketingOptOut
boolean
emails
object[]
phoneNumbers
object[]
customProperties
object

Custom property values, keyed by property id. Ids and value types come from the properties defined for your partner, so this object cannot be described field by field here: an unknown id or a value that does not match the property type is rejected with 400. Only the ids you send are modified — omit a property to leave it untouched. To clear one, send null; a blank string and an empty array count as empty too, for every property type alike.

Example:

Response

Updated client

id
string
required
Pattern: ^ovcid-.*$
name
string
required
firstName
string
required
lastName
string
required
createdAt
string<date-time>
required
customProperties
object
required

Custom property values, keyed by property id. Ids and value types come from the properties defined for your partner, so this object cannot be described field by field here — call the custom-property list endpoint to resolve an id to its name and type. A property never given a value takes the default configured for it, and is left out rather than returned as null when there is no default either. A value stored before its property was changed — an option renamed or removed, the type switched — is returned as stored, so it may not match the type the property has today; an absent key is the only reliable sign that nothing is set.

Example:
partnerName
string
marketingOptOut
boolean
emails
object[]
phoneNumbers
object[]
updatedAt
string<date-time>