Credential Templates

Upload credential template background cover image.

put

Accepts the next image formats: image/jpeg, image/png, image/webp. Max size is: 5242880 bytes.

---

Claim-based access control: Issuer_Admin, Issuer_User

Authorizations

COGNIT_JWTCUSTOMER_USER_API_KEY

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

correlationIdstringRequired

Defines a organisation which is defined as a correlationId. Must be a value the Issuer is working with!

Example: teranode

credentialIdstringRequired

Defines the credential type

Example: emailCredential

Body

multipart/form-data

imagestring · binaryOptional

Responses

200Success

application/json

400

Invalid request body.

401

Invalid authentication credentials.

403

User does not have a required claim to perform this operation.

413

Image exceeds the allowed size.

415

Unsupported media type.

500

Internal server error.

put

/api/v1/credential-templates/correlation/{correlationId}/credential/{credentialId}/background-cover-upload

HTTPcURLJavaScriptPython

PUT /products/web/12345/issuer/api/v1/credential-templates/correlation/{correlationId}/credential/{credentialId}/background-cover-upload HTTP/1.1
Host: identity.products.teranode.group
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 18

{
  "image": "binary"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2025-12-22T11:27:44.882Z",
  "updatedAt": "2025-12-22T11:27:44.882Z",
  "correlationId": "teranode",
  "credentialId": "emailCredential",
  "isDefaultCoverImage": true,
  "coverImage": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "mimeType": "image/jpeg",
    "keyUrl": "text",
    "filename": "text",
    "sizeInBytes": 1,
    "type": "cover_image"
  }
}

Fetch credential templates

get

Fetch all the information related to the credential templates

---

Claim-based access control: Issuer_Admin, Issuer_User, Issuer_Auditor

Authorizations

COGNIT_JWTCUSTOMER_USER_API_KEY

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

correlationIdstringRequired

Defines a organisation which is defined as a correlationId. Must be a value the Issuer is working with!

Example: teranode

Query parameters

credentialIdstringOptional

Defines the credential type

Example: emailCredential

Responses

200Success

application/json

400

Invalid request body.

401

Invalid authentication credentials.

403

User does not have a required claim to perform this operation.

500

Internal server error.

get

/api/v1/credential-templates/correlation/{correlationId}

HTTPcURLJavaScriptPython

GET /products/web/12345/issuer/api/v1/credential-templates/correlation/{correlationId} HTTP/1.1
Host: identity.products.teranode.group
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "credentials": [
    {
      "correlationId": "teranode",
      "credentialId": "emailCredential",
      "isDefaultCoverImage": true,
      "coverImage": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "mimeType": "image/jpeg",
        "keyUrl": "text",
        "filename": "text",
        "sizeInBytes": 1,
        "type": "cover_image"
      },
      "display": [
        {
          "name": "Email Credential",
          "description": "Email Credential for Organisation",
          "background_image": {
            "url": "https://cloudfront.example.com/some-path/1/emailCredential"
          }
        }
      ],
      "format": "jwt_vc_json",
      "fieldOrder": [
        "email"
      ],
      "fields": {
        "ANY_ADDITIONAL_PROPERTY": {
          "value_type": "string",
          "mandatory": true,
          "display": [
            {
              "name": "text",
              "locale": "text"
            }
          ],
          "format": "date",
          "minLength": 1,
          "maxLength": 1,
          "pattern": "text",
          "patternDescription": "text",
          "enum": [
            "text"
          ],
          "enumName": "country",
          "enumAllowOther": false,
          "minDate": "text",
          "maxDate": "text",
          "min": 1,
          "max": 1,
          "valueTips": [
            "text"
          ],
          "suggestedInputType": "radio",
          "groupId": "text",
          "groupOrder": 1,
          "groupSize": 1,
          "groupLabel": "text"
        }
      }
    }
  ]
}

Deletes the credential template cover image and reverts back to the Issuer default one if exists else throws an error.

delete

Delete credential template cover image.

---

Claim-based access control: Issuer_Admin, Issuer_User

Authorizations

COGNIT_JWTCUSTOMER_USER_API_KEY

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

correlationIdstringRequired

Defines a organisation which is defined as a correlationId. Must be a value the Issuer is working with!

Example: teranode

credentialIdstringRequired

Defines the credential type

Example: emailCredential

Responses

204

Successfully deleted

400

Invalid request params.

401

Invalid authentication credentials.

403

User does not have a required claim to perform this operation.

500

Internal server error.

delete

/api/v1/credential-templates/correlation/{correlationId}/credential/{credentialId}/cover-image

HTTPcURLJavaScriptPython

DELETE /products/web/12345/issuer/api/v1/credential-templates/correlation/{correlationId}/credential/{credentialId}/cover-image HTTP/1.1
Host: identity.products.teranode.group
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content