Import issues

POST/api/v1/workspaces/{slug}/certificates/{id}/issues

Import recipients as pending certificate issues

Enrols recipients against a certificate. Each accepted row becomes a pending issue. Duplicate emails (already enrolled for this certificate) are listed in rejected and skipped.

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

Certificate id

Example: 550e8400-e29b-41d4-a716-446655440000

Body parameters

issues*array

Recipients to import

Each item in issues:

email*string

Recipient email (must be a valid email address)

Example: [email protected]

name?string

Display name

Example: Ada Lovelace

attributes?object

Certificate attribute values; keys should be lowercase snake_case

Example: { "course": "Mathematics", "roll_number": "CS-001" }

expires_at?string

RFC3339 expiry override for this recipient (must be in the future). When omitted, the certificate validity_days policy applies

Example: 2027-09-03T09:00:00Z

Response schema

*Issue[]

Newly created pending issues

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)

rejected*string[]

Emails skipped (already enrolled for this certificate)