VerifycateDeveloper Docs

Approve a request-form submission

POST/api/v1/workspaces/{slug}/requests/{id}/approve

Approve a pending request and issue the certificate

Approves a request-form submission and issues the certificate to the recipient from the submitted fields. Returns the created (or updated) issue.

Already-approved submissions return 409 with code submission_already_approved.

Authorization

Scopecertificates:write
Authorization: Bearer vc_...

Requires certificates:write (or full access) and an active Pro seat.

Path parameters

slug*string

Workspace slug

Example: acme
id*UUID

Submission id

Example: c1a2b3d4-5e67-4890-a123-456789abcdef

Response schema

id*UUID
Issue id
certificate_id*UUID
Parent certificate id
user_id?UUID
Linked user id when known
public_id*string
Public verification id
recipient_email*string
Recipient email
recipient_name*string
Recipient display name
attributes*object
Recipient attribute values keyed by certificate attribute keys
status*string
`pending` or `active` (expired is derived on public verify)
issued_at?datetime
When the credential was issued
expires_at?datetime
When the credential expires
notified_at?datetime
When the recipient was last notified
notify_type*string
Notification channel used
current_version_id?UUID
Current issued version id when issued
template_version?integer
Template version baked into the credential
created_at*datetime
Created timestamp (RFC 3339)
updated_at*datetime
Updated timestamp (RFC 3339)