Management
Update Customer
Update an existing customer record
PUT
/
customers
/
api
/
manage
/
{customerId}
curl -X PUT "https://api.trusset.org/customers/api/manage/cmt0k3b9x0004cghxw7r2d5ya" \
-H "Content-Type: application/json" \
-H "X-API-Key: trusset_abc123xy_secret..." \
-d '{ "country": "AT", "investorType": "PROFESSIONAL" }'
const response = await fetch(
'https://api.trusset.org/customers/api/manage/cmt0k3b9x0004cghxw7r2d5ya',
{
method: 'PUT',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'trusset_abc123xy_secret...'
},
body: JSON.stringify({ country: 'AT', investorType: 'PROFESSIONAL' })
}
);
const { data: updated } = await response.json();
{
"success": true,
"data": {
"id": "cmt0k3b9x0004cghxw7r2d5ya",
"instanceId": "cmrz4d1v20000cghx8k6p3m7t",
"issuerId": "cmrz3a8q10000cghxf5w2n9k4",
"walletAddress": "0xaBc123DEf456789012345678901234567890aBCD",
"externalId": "acme-001",
"name": "Acme Corp",
"country": "AUT",
"investorType": "PROFESSIONAL",
"customerType": "COMPANY",
"companyUrl": "https://acme.example/",
"companyId": null,
"status": "verified",
"frozen": false,
"kycHash": "0x5f1c2e8a9b7d4c3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b7c6d5e4f3a2b1c0d9e",
"onChainTxHash": "0x8e2d41c7a9f03b56d1e8c4a27f90b3d65e1c8a4f27b90d3e6c1a85f42d97b0e3",
"sumsubApplicantId": null,
"idLinkId": null,
"referenceKey": null,
"contactChannels": [],
"metadata": null,
"archived": false,
"archivedAt": null,
"verifiedAt": "2026-09-01T10:00:00.000Z",
"revokedAt": null,
"onChainSyncedAt": null,
"createdAt": "2026-08-15T08:00:00.000Z",
"updatedAt": "2026-09-30T12:00:00.000Z"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-09-30T12:00:00.000Z"
}
}
Updates fields on an existing customer. Only the provided fields are modified; omitted fields remain unchanged. Fields not listed below, such as
When
externalId, are ignored.
The
walletAddress and status fields change the record only, never the registry. A new wallet address replaces the primary outright. The old primary is dropped rather than kept as a linked wallet. The record’s status, verifiedAt and kycHash stay as they were. Sending null removes the primary.These fields can still reach the registry later. When the instance switches identity registers, each verified record that holds a kycHash is queued for registration on the new register, with that kycHash, under its current primary.To swap primaries and keep the old one, use Add Wallet and then Promote Wallet.Path Parameters
string
required
Customer ID.
Body Parameters
string
Updated display name.
string
ISO 3166-1 alpha-2, alpha-3 or numeric code, stored as alpha-3.
null or an empty string clears it.string
The same values as on Create Customer: a preset or the key of one of your custom verification profiles, in any letter case, stored as the profile spells it.
null, an empty string, or the record’s current type in another letter case leaves the type as it is, also when that profile is disabled. Moving the record onto a disabled profile is refused with INVALID_INVESTOR_TYPE. Anything else, a number included, is refused with INVALID_INVESTOR_TYPE.string
Replaces the primary wallet. Stored checksummed. Read the warning above before sending it.
string
pending, active, verified, revoked or rejected, in any letter case, stored in lowercase. Any other value, null included, is refused with INVALID_STATUS. It is not checked against the registry. Setting revoked on a record that was not revoked also stamps revokedAt.A verified status set here marks the record only. It does not count as a verification completed on your instance, so a lending market priced from a live market price still refuses a professional client whose status was set this way with NOT_VERIFIED, unless one of its wallets is admitted to a professional profile. See Client of record.object
Updated metadata. Replaces existing metadata entirely. The platform keeps
idLinks here, the ID links created for this customer, and on an ERC-3643 register also onchainId and onchainIdTxHash. Carry all three over. Without idLinks, an older ID link no longer finds this customer when it completes, and can create a second record or be refused. Without the ONCHAINID fields, registering a wallet that is not yet on the register plans a new ONCHAINID deployment instead of reusing the one already deployed.string
A base64 data URL of a PNG, JPEG, WEBP or GIF image, up to 250,000 characters. Stored as
metadata.avatarUrl. null or an empty string removes it.string[]
Replaces the list. Up to 20 strings of up to 200 characters each, trimmed, with blank entries dropped and duplicates removed ignoring case.
null empties it.string
Company records only. Normalised as on Create Customer.
null or an empty string clears it.string
Individual records only. The ID of a company record on your instance that is not archived.
null or an empty string unlinks it.string
Accepted only when it matches the record’s current type. A different value is refused with
TYPE_IMMUTABLE.country or investorType is sent, the resulting pair is checked. A country on the blocked-country list of the profile that investorType names is refused with COUNTRY_BLOCKED.
Response Fields
boolean
Request status
object
The updated customer record, with the fields listed on Get Customer other than its linked wallets, company links, Sumsub applicant record and audit entries.
curl -X PUT "https://api.trusset.org/customers/api/manage/cmt0k3b9x0004cghxw7r2d5ya" \
-H "Content-Type: application/json" \
-H "X-API-Key: trusset_abc123xy_secret..." \
-d '{ "country": "AT", "investorType": "PROFESSIONAL" }'
const response = await fetch(
'https://api.trusset.org/customers/api/manage/cmt0k3b9x0004cghxw7r2d5ya',
{
method: 'PUT',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'trusset_abc123xy_secret...'
},
body: JSON.stringify({ country: 'AT', investorType: 'PROFESSIONAL' })
}
);
const { data: updated } = await response.json();
{
"success": true,
"data": {
"id": "cmt0k3b9x0004cghxw7r2d5ya",
"instanceId": "cmrz4d1v20000cghx8k6p3m7t",
"issuerId": "cmrz3a8q10000cghxf5w2n9k4",
"walletAddress": "0xaBc123DEf456789012345678901234567890aBCD",
"externalId": "acme-001",
"name": "Acme Corp",
"country": "AUT",
"investorType": "PROFESSIONAL",
"customerType": "COMPANY",
"companyUrl": "https://acme.example/",
"companyId": null,
"status": "verified",
"frozen": false,
"kycHash": "0x5f1c2e8a9b7d4c3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b7c6d5e4f3a2b1c0d9e",
"onChainTxHash": "0x8e2d41c7a9f03b56d1e8c4a27f90b3d65e1c8a4f27b90d3e6c1a85f42d97b0e3",
"sumsubApplicantId": null,
"idLinkId": null,
"referenceKey": null,
"contactChannels": [],
"metadata": null,
"archived": false,
"archivedAt": null,
"verifiedAt": "2026-09-01T10:00:00.000Z",
"revokedAt": null,
"onChainSyncedAt": null,
"createdAt": "2026-08-15T08:00:00.000Z",
"updatedAt": "2026-09-30T12:00:00.000Z"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-09-30T12:00:00.000Z"
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
INVALID_STATUS | 400 | status is not pending, active, verified, revoked or rejected. Checked before the record is looked up |
INVALID_COUNTRY | 400 | country is not an ISO 3166-1 code |
INVALID_INVESTOR_TYPE | 400 | investorType names neither a preset nor one of your verification profiles, names a disabled profile the record is not already under, or is not a string |
TYPE_IMMUTABLE | 400 | customerType differs from the record’s type |
INVALID_COMPANY_URL | 400 | companyUrl was sent for an individual, or is not a usable URL |
COMPANY_URL_TOO_LONG | 400 | companyUrl is over 300 characters |
COMPANY_CANNOT_LINK | 400 | companyId was sent for a company |
INVALID_COMPANY | 400 | companyId is not a string of 20 to 40 characters, or is the record’s own ID |
INVALID_ADDRESS | 400 | walletAddress is not a valid address |
INVALID_CONTACT_CHANNELS | 400 | contactChannels is not an array |
TOO_MANY_CONTACT_CHANNELS | 400 | More than 20 contact channels |
INVALID_CONTACT_CHANNEL | 400 | A contact channel is not a string |
CONTACT_CHANNEL_TOO_LONG | 400 | A contact channel is over 200 characters |
INVALID_AVATAR | 400 | avatarUrl is not a base64 PNG, JPEG, WEBP or GIF data URL |
COUNTRY_BLOCKED | 403 | The resulting country is on the blocked-country list of the profile the resulting investorType names |
NOT_FOUND | 404 | No such customer on your instance, or the record is archived |
COMPANY_NOT_FOUND | 404 | companyId names no company record on your instance that is not archived |
CUSTOMER_EXISTS | 409 | walletAddress is another active customer’s primary or another customer’s linked wallet |
AVATAR_TOO_LARGE | 413 | avatarUrl is over 250,000 characters |
UPDATE_FAILED | 500 | The update could not be written |
⌘I
curl -X PUT "https://api.trusset.org/customers/api/manage/cmt0k3b9x0004cghxw7r2d5ya" \
-H "Content-Type: application/json" \
-H "X-API-Key: trusset_abc123xy_secret..." \
-d '{ "country": "AT", "investorType": "PROFESSIONAL" }'
const response = await fetch(
'https://api.trusset.org/customers/api/manage/cmt0k3b9x0004cghxw7r2d5ya',
{
method: 'PUT',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'trusset_abc123xy_secret...'
},
body: JSON.stringify({ country: 'AT', investorType: 'PROFESSIONAL' })
}
);
const { data: updated } = await response.json();
{
"success": true,
"data": {
"id": "cmt0k3b9x0004cghxw7r2d5ya",
"instanceId": "cmrz4d1v20000cghx8k6p3m7t",
"issuerId": "cmrz3a8q10000cghxf5w2n9k4",
"walletAddress": "0xaBc123DEf456789012345678901234567890aBCD",
"externalId": "acme-001",
"name": "Acme Corp",
"country": "AUT",
"investorType": "PROFESSIONAL",
"customerType": "COMPANY",
"companyUrl": "https://acme.example/",
"companyId": null,
"status": "verified",
"frozen": false,
"kycHash": "0x5f1c2e8a9b7d4c3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b7c6d5e4f3a2b1c0d9e",
"onChainTxHash": "0x8e2d41c7a9f03b56d1e8c4a27f90b3d65e1c8a4f27b90d3e6c1a85f42d97b0e3",
"sumsubApplicantId": null,
"idLinkId": null,
"referenceKey": null,
"contactChannels": [],
"metadata": null,
"archived": false,
"archivedAt": null,
"verifiedAt": "2026-09-01T10:00:00.000Z",
"revokedAt": null,
"onChainSyncedAt": null,
"createdAt": "2026-08-15T08:00:00.000Z",
"updatedAt": "2026-09-30T12:00:00.000Z"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-09-30T12:00:00.000Z"
}
}