Create an issuer credential definition
Creates a project-scoped credential definition. Authbound-approved global
definitions remain available alongside project-specific definitions.
Omitted lifecycleStatus creates a draft. Explicit published creation must
satisfy publish readiness immediately.
Customer-controlled deployments create a published dc+sd-jwt definition that is issuable at once, with
localized display, typed claims, validity, optional uniqueness, aliases and metadata. Without a vct, the
definition gets a URL under the project’s issuer, {issuer origin}/issuers/{project_id}/types/{credentialDefinitionId}.
A vct or alias in a reserved namespace (urn:vc:authbound:, urn:eudi:, urn:eu.europa.ec., eu.europa.ec., org.iso.),
one containing a backslash, a URL on the issuer’s host other than the definition’s own default vct, or a value
any other definition uses (the project’s other definitions included) returns 400 naming vct or aliases. A
definition that moves to a new vct may keep its old one, its default vct included, as an alias. Display, claims, validity and uniqueness
together must fit the issuer’s 32 KiB definition document; past it, 400 names definition. Drafts, title,
rendering and lifecycleStatus are not accepted and return 400. Each Project owns its own credentialDefinitionId
namespace.
Authorizations
Server-side secret key header. Format: sk_live_* (production) or sk_test_* (testing).
Headers
Unique key for idempotent requests
255Body
- Option 1
- Option 2
1 - 256"pension_credential_v1"
1 - 2048"urn:vc:authbound:pension:1.0"
dc+sd-jwt, jwt_vc_json 1 - 256"Pension Credential"
1 - 256 elementsPublished creation must satisfy publish readiness.
published 2561 - 2048["pension", "pension_credential"]Caller-owned metadata for managing the definition. It is not embedded into issued credentials. Runtime additionally enforces eight JSON levels and 1,024 total nodes.
Response
Credential definition created
- Option 1
- Option 2
- Option 3
"issuer.credential_definition"1 - 256"pension_credential_v1"
1 - 256"pension_credential_v1"
dc+sd-jwt, mso_mdoc, jwt_vc_json 1 - 2048"urn:vc:authbound:pension:1.0"
1 - 256"Pension Credential"
2562562048draft, published, archived "draft"Caller-owned metadata for managing the definition. It is not embedded into issued credentials. Runtime additionally enforces eight JSON levels and 1,024 total nodes.