Skip to main content

Delete a Document

Removes an identity document from a customer's verification record. The slot is freed and its bytes return to the record's budget. To replace a document, you can also presign its slot again.

Takes a workspace-scoped API key or a dashboard session. An account-scoped key is refused with 401.

New in v3: v2 has no equivalent.

Authorization:

Every request is signed with your API key: a short-lived JWT, signed with your private key, sent in one header on /v3/* and /api/v2/* alike.

Headers:
Authorization: APIKey {SIGNED_JWT}

How to build and sign the JWT: Authentication.

Endpoint

DELETE

/v3/customers/{customer_id}/kyc/documents/{document_id}

Path parameters​

ParameterTypeDescription
customer_idstring (cst_…)Required. The customer. Its record must be pending or needs_update.
document_idstring (doc_…)Required. The document.

Response​

204 No Content, with no body.

Errors​

StatusmessageWhen
400failed to parse requestcustomer_id or document_id is not a TypeID of its kind.
401unauthorizedMissing or invalid signature, or the caller is an account-scoped key or a customer session.
403forbiddenA dashboard member whose role does not allow this. A workspace-scoped key always may.
404kyc_not_foundThe customer has no record.
404document_not_foundThe record has no document with this id.
409kyc_verification_in_flightThe record is in_review.
409kyc_already_approvedThe record is approved.
409kyc_rejectedThe record is rejected.

Support and Resources​

If you need assistance or have any questions, our support team is here to help. You can contact our support team at support@blockwyre.com.

Stay Updated​

Stay up-to-date with the latest news, updates, and features from BlockWyre by following us on social media:

We are excited to have you on board and look forward to seeing how you leverage BlockWyre's powerful tools to enhance your financial operations. Happy integrating!