API Reference

Update

patch
https://api.certify.one/api/v2/issuer-api/issued-credentials/

Update an issued credential by its uuid. At least one of
completion_date, expiration_date or certificate_pdf_url is required.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Body Params
date
  • required when expiration_date and certificate_pdf_url are not present
  • only yyyy-mm-dd format is allowed
  • must be today or earlier in UTC (a future date is rejected)
  • set to null to reset this field
date
  • required when completion_date and certificate_pdf_url are not present
  • only yyyy-mm-dd format is allowed
  • set to null to reset this field
uri
length ≤ 2048
  • optional, tri-state:
  • omit the field to keep the current certificate unchanged
  • send a new https url to replace the certificate with that PDF
  • send an empty value ("" or null) to remove the external certificate
    and fall back to the badge's design template (or none)
boolean
Defaults to true
  • optional
  • default is true
  • accepted input are true, false, 1, 0, "1", "0"
Responses

error is Unauthenticated when no token
is sent and Invalid Issuer Key when it matches no account.

error is
Account suspended when a payment is outstanding and No active contract
when your plan has ended. Reading, revoking and deleting are never refused
this way.

message says what was not found, for example
issued credential not found, credential not found or recipient not found.

message plus errors, with one list of messages
per invalid field;
  • plan limit reached (issuing only): error is Customer limit exceeded
    and details carries your usage.

    • Retry-After header before trying again.

    Updated 3 months ago

    Did this page help you?
    Language
    Credentials
    Bearer
    LoadingLoading…
    Response
    Click Try It! to start a request and see the response here! Or choose an example:
    application/json

    Updated 3 months ago

    Did this page help you?