Sign in
Credentials

Create a credential schema

Create a new credential schema for the authenticated tenant. The schema defines the verifiable-credential type, wire format, claim attributes (and which are selectively disclosable), whether issued credentials are revocable, and optional wallet branding. The combination of name + version must be unique within the tenant. Once created, the schema can be referenced by credential templates. The revocable flag is immutable after creation. Requires Authorization: Bearer <tenant API key>.

post/v1/credential-schemas

Request body

namestring required

Human-readable name of the schema. Must be unique per tenant together with version.

versionstring

Schema version string. Must be unique per tenant together with name. Defaults to "1.0".

vctstring required

Verifiable Credential Type identifier to embed in every credential issued under this schema. Wallets and verifiers match on this value.

format'sd_jwt_vc' | 'mdoc' | 'w3c'

Credential wire format. sd_jwt_vc (IETF SD-JWT VC) is the default; mdoc is ISO/IEC 18013-5; w3c is W3C VC 2.0. Defaults to sd_jwt_vc.

revocableboolean

Whether credentials issued under this schema can be revoked or suspended through a status list. Immutable after creation. Defaults to true.

brandingobject

Optional free-form wallet branding object (e.g. background color, text color, logo URI) used by holder wallets to render the credential. Defaults to an empty object.

Example request

{
  "name": "Loyalty Membership",
  "version": "1.0",
  "vct": "https://acme-air.didit.me/credentials/loyalty-membership",
  "format": "sd_jwt_vc",
  "attributes": [
    {
      "name": "given_name",
      "type": "string",
      "sd": true
    }
  ],
  "revocable": true,
  "branding": {
    "background_color": "#2567FF",
    "text_color": "#FFFFFF",
    "logo_uri": "https://acme-air.didit.me/logo.png"
  }
}

Response

No response body

Changes