v8

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-05730512.7 KB

Credentials

Create a credential template

Create an issuance template for a credential schema. You provide the schema UUID, template name, and validity duration. Use the returned template UUID when you issue credentials.

post/v1/credential-templates

Request body

schemastring uuid required

UUID of the schema to bind to this template.

namestring required

Human-readable template name.

validity_secondsinteger

Credential validity duration, in seconds, applied during issuance.

Example request

{
  "schema": "2e844e4b-e7da-4d94-828e-eee9bdf66349",
  "name": "standard",
  "validity_seconds": 31536000
}

Response

The credential template was created.

uuidstring uuid

Unique identifier of the credential template.

schemastring uuid

UUID of the schema bound to this template.

namestring

Human-readable template name.

validity_secondsinteger

Credential validity duration, in seconds, applied during issuance.

created_atstring date-time

Timestamp when the template was created.

Example response

{
  "uuid": "5588f83f-620b-4614-8ffa-933634a0b708",
  "schema": "2e844e4b-e7da-4d94-828e-eee9bdf66349",
  "name": "standard",
  "validity_seconds": 31536000,
  "created_at": "2026-07-02T23:33:33.479128Z"
}