Skip to main content
POST
Rejects a record in status RECEIVED or OPENED. The record becomes REJECTED, Trusset deletes the ciphertext if it still holds it, and a customer.kyc_record_rejected event with the reason goes to your customer webhooks. The source reads the status and the reason from Get Delivery Status. Your local tool calls this on its own when an envelope from a pinned source fails a cryptographic check. You call it for a record you reviewed and do not accept. A rejection is final for the record. The source can deliver a new record for the same wallet. Rejecting a record that is already REJECTED changes nothing and answers with the record.

Reasons

Trusset treats the six reasons the same way and shows the code to the source. The reason is a code only: this endpoint takes no free text.

Path Parameters

string
required
The record id from List KYC Records.

Body Parameters

string
required
One of the six codes above, in any letter case.

Response Fields

object
The rejection is written to the customer audit log as KYC_RECORD_REJECTED, with the reason and the status the record had before.

Error Codes