ID Links
Revoke ID Link
Stop a verification link from being opened
PUT
/
customers
/
api
/
id-links
/
{linkId}
/
revoke
curl -X PUT "https://api.trusset.org/customers/api/id-links/cmg6b2t9x0001lb08q4w7k3fz/revoke" \
-H "X-API-Key: trusset_your_key_here"
const response = await fetch(
'https://api.trusset.org/customers/api/id-links/cmg6b2t9x0001lb08q4w7k3fz/revoke',
{
method: 'PUT',
headers: { 'X-API-Key': 'trusset_your_key_here' }
}
);
const { success, error } = await response.json();
{
"success": true,
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-09-30T10:00:00.000Z"
}
}
Stops the hosted page from opening a link. Use it when a link went to the wrong person or the onboarding is cancelled.
The link’s status becomes
Revoking does not refund a fee the customer already paid, and no endpoint does.A revoked link ignores every review that arrives afterwards, also for a check the customer had already submitted. The link stays
EXPIRED, nothing is queued and no customer record changes, so a customer who passes that check later must be onboarded again with a new link. See A review settles once.EXPIRED and expiresAt is set to the time of revocation. There is no separate revoked status, so a revoked link lists as EXPIRED.
Nothing else changes. The customer record, a queued registration and any on-chain identity stay as they are. A wallet already registered through the link is removed with Revoke Identity.
A COMPLETED link cannot be revoked. A REJECTED link can be, and revoking an EXPIRED link succeeds again.
Path Parameters
string
required
The link
id from Create ID Link or List ID Links. Not the token.Response Fields
boolean
true. The response carries no data.curl -X PUT "https://api.trusset.org/customers/api/id-links/cmg6b2t9x0001lb08q4w7k3fz/revoke" \
-H "X-API-Key: trusset_your_key_here"
const response = await fetch(
'https://api.trusset.org/customers/api/id-links/cmg6b2t9x0001lb08q4w7k3fz/revoke',
{
method: 'PUT',
headers: { 'X-API-Key': 'trusset_your_key_here' }
}
);
const { success, error } = await response.json();
{
"success": true,
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-09-30T10:00:00.000Z"
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
NOT_FOUND | 404 | No link with this ID exists on your instance |
ALREADY_COMPLETED | 400 | The link is COMPLETED |
REVOKE_FAILED | 500 | The link could not be updated |
⌘I
curl -X PUT "https://api.trusset.org/customers/api/id-links/cmg6b2t9x0001lb08q4w7k3fz/revoke" \
-H "X-API-Key: trusset_your_key_here"
const response = await fetch(
'https://api.trusset.org/customers/api/id-links/cmg6b2t9x0001lb08q4w7k3fz/revoke',
{
method: 'PUT',
headers: { 'X-API-Key': 'trusset_your_key_here' }
}
);
const { success, error } = await response.json();
{
"success": true,
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-09-30T10:00:00.000Z"
}
}