Credential Designs: Assets
Catalog id: resource.credentialDesigns.assets
Assets are the binary files designs and render variants reference: logos, background images, SVG templates. They are content-addressed and deduplicated for the tenant. Upload once, reuse from many render variants and issuer designs.
Do not treat assets as credential types. They have no claims and do not appear in issuer metadata by themselves.
Guide context: Credential designs.
Open it
| Navigation | Resources > Credential Designs > Assets |
| Deep link | #resource=credentialDesigns&rarea=assets |
| Scope | Tenant |
Library
Grid of uploaded assets with content type. Filter by asset type when the library is large. Open a tile for detail and a client-side used by list of render variants that reference the same URI, so you can see impact before replacing a logo.
Empty library means nothing was uploaded and sample data did not seed assets. Upload before you expect logos on cards.
Upload
Pick asset type and file, preview, then confirm. Prefer PNG/SVG that wallets can render at small sizes. Very large images waste bandwidth for every holder who opens the card.
The API returns a stable URI (and integrity hash when provided). Put that URI on a render variant logo/background slot or on issuer display branding.
REST
Upload logo for a credential design context (EuPid example path uses design-scoped asset routes in the walkthrough capture):
- Overview
- Request
- Response
Upload EuPid logo asset
Endpoint: POST /api/credential-design/v1/designs/credentials/00000000-0000-4000-8000-000000000000/assets/en/LOGO
Captured response: 201 Created
This captured endpoint is shown from the E2E run; it is not mapped to one of the generated EDK REST API reference pages.
Connect an environment to rewrite this call to real service bases and run it.
mdoc logo example:
- Overview
- Request
- Response
Upload Mdl logo asset
Endpoint: POST /api/credential-design/v1/designs/credentials/00000000-0000-4000-8000-000000000000/assets/en/LOGO
Captured response: 201 Created
This captured endpoint is shown from the E2E run; it is not mapped to one of the generated EDK REST API reference pages.
Connect an environment to rewrite this call to real service bases and run it.
Issuer logo upload:
- Overview
- Request
- Response
Upload issuer logo asset
Endpoint: POST /api/credential-design/v1/designs/credentials/00000000-0000-4000-8000-000000000000/assets/en/LOGO
Captured response: 201 Created
This captured endpoint is shown from the E2E run; it is not mapped to one of the generated EDK REST API reference pages.
Connect an environment to rewrite this call to real service bases and run it.
Credential design API. Guide: Credential designs.