Skip to content

Approve Certificate

PUT
/certificates/certificates/{documentId}/approve

Strapi v5 Admin API endpoint handled by admin.approveCertificate.

documentId
required
string

Target documentId identifier

object
key
additional properties
any

Successful response

object
data

Cryptographically signed official certificate record with signatory and witness attestation

object
documentId

Strapi v5 Document Service unique identifier

string
serialNumber
required
string
<= 64 characters
templateDocumentId
required
string
<= 120 characters
templateSlug
required
string
<= 120 characters
templateName
required
string
<= 160 characters
status
required
string
default: pending_approval
Allowed values: pending_approval issued revoked expired
recipientFullName
required
string
<= 200 characters
recipientChosenName
string
<= 200 characters
recipientEmail
string format: email
recipientPhone
string
<= 64 characters
recipientNationality
string
<= 120 characters
nationalIdMasked
string
<= 32 characters
issuedAt
required
string
<= 40 characters
expiresAt
string
<= 40 characters
revokedAt
string
<= 40 characters
revocationReason
string
signatories
object
key
additional properties
any
witnesses
object
key
additional properties
any
customData
object
key
additional properties
any
secondaryDates
object
key
additional properties
any
canonicalPayloadHash
required
string
<= 128 characters
cryptographicSignature
required
string
publicKeyFingerprint
required
string
<= 96 characters
esignProvider
string
default: none
Allowed values: none docusign docuseal webhook
esignEnvelopeId
string
<= 128 characters
esignEnvelopeStatus
string
default: not_sent
Allowed values: not_sent sent delivered completed declined voided
esignCompletedAt
string
<= 40 characters
linkedBookingCode
string
<= 64 characters
notes
string

Bad Request — validation or parameter error

Unauthorized — missing or invalid Bearer token

Forbidden — insufficient Strapi RBAC permissions