Themes

UI theme selection and customization.

Returns a list of all themes.

get

Returns a list of all themes. Only users with the Standard Registry role are allowed to make the request.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successful operation.

application/json

idstringRequired

Internal database identifier

Example: 69aeb71ef8c5b278e3bab4e5

createDatestringRequired

Creation date in ISO 8601 format

Example: 2026-03-03T17:25:53.312Z

updateDatestringRequired

Last update date in ISO 8601 format

Example: 2026-03-03T17:25:53.312Z

uuidstringRequired

Unique universal identifier

Example: 9db028d2-03ad-4d49-a178-cf4b67f8c147

ownerstringRequired

DID of the theme owner

Example: did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599

namestringRequired

Theme name

Example: Theme name

401

Unauthorized request.

application/json

403

Forbidden

application/json

500

Internal server error.

application/json

get/themes

GET /api/v1/themes HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "createDate": "2026-03-25T14:36:51.320Z",
    "updateDate": "2026-03-25T14:36:51.320Z",
    "uuid": "71725b88-1801-4ab6-b672-3c133cd73e89",
    "name": "Test Theme",
    "owner": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
    "rules": [
      {
        "description": "Container style",
        "text": "#ffffff",
        "background": "#1a1a2e",
        "border": "#16213e",
        "shape": "0",
        "borderWidth": "2px",
        "filterType": "type",
        "filterValue": "interfaceContainerBlock"
      }
    ],
    "id": "69c3f303810b639b34bae861"
  }
]

Creates a new theme.

post

Creates a new theme. Only users with the Standard Registry role are allowed to make the request.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

idstringRequired

Internal database identifier

Example: 69aeb71ef8c5b278e3bab4e5

createDatestringRequired

Creation date in ISO 8601 format

Example: 2026-03-03T17:25:53.312Z

updateDatestringRequired

Last update date in ISO 8601 format

Example: 2026-03-03T17:25:53.312Z

uuidstringRequired

Unique universal identifier

Example: 9db028d2-03ad-4d49-a178-cf4b67f8c147

ownerstringRequired

DID of the theme owner

Example: did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599

namestringRequired

Theme name

Example: Theme name

Responses

201

Successful operation.

application/json

idstringRequired

Internal database identifier

Example: 69aeb71ef8c5b278e3bab4e5

createDatestringRequired

Creation date in ISO 8601 format

Example: 2026-03-03T17:25:53.312Z

updateDatestringRequired

Last update date in ISO 8601 format

Example: 2026-03-03T17:25:53.312Z

uuidstringRequired

Unique universal identifier

Example: 9db028d2-03ad-4d49-a178-cf4b67f8c147

ownerstringRequired

DID of the theme owner

Example: did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599

namestringRequired

Theme name

Example: Theme name

401

Unauthorized request.

application/json

403

Forbidden

application/json

500

Internal server error.

application/json

post/themes

POST /api/v1/themes HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 437

{
  "id": "69aeb71ef8c5b278e3bab4e5",
  "createDate": "2026-03-03T17:25:53.312Z",
  "updateDate": "2026-03-03T17:25:53.312Z",
  "uuid": "9db028d2-03ad-4d49-a178-cf4b67f8c147",
  "owner": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
  "name": "Theme name",
  "rules": [
    {
      "description": "Description",
      "text": "#000000",
      "background": "#000000",
      "border": "#000000",
      "shape": "0",
      "borderWidth": "2px",
      "filterType": "type",
      "filterValue": "text"
    }
  ]
}

{
  "createDate": "2026-03-25T14:36:51.320Z",
  "updateDate": "2026-03-25T14:36:51.320Z",
  "uuid": "71725b88-1801-4ab6-b672-3c133cd73e89",
  "name": "Test Theme",
  "owner": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
  "rules": [
    {
      "description": "Container style",
      "text": "#ffffff",
      "background": "#1a1a2e",
      "border": "#16213e",
      "shape": "0",
      "borderWidth": "2px",
      "filterType": "type",
      "filterValue": "interfaceContainerBlock"
    }
  ],
  "id": "69c3f303810b639b34bae861"
}

Updates theme configuration.

put

Updates theme configuration for the specified theme ID. Only users with the Standard Registry role are allowed to make the request.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

themeIdstringRequired

Theme Identifier

Example: 69aeb71ef8c5b278e3bab4e5

Body

idstringRequired

Internal database identifier

Example: 69aeb71ef8c5b278e3bab4e5

createDatestringRequired

Creation date in ISO 8601 format

Example: 2026-03-03T17:25:53.312Z

updateDatestringRequired

Last update date in ISO 8601 format

Example: 2026-03-03T17:25:53.312Z

uuidstringRequired

Unique universal identifier

Example: 9db028d2-03ad-4d49-a178-cf4b67f8c147

ownerstringRequired

DID of the theme owner

Example: did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599

namestringRequired

Theme name

Example: Theme name

Responses

200

Successful operation.

application/json

idstringRequired

Internal database identifier

Example: 69aeb71ef8c5b278e3bab4e5

createDatestringRequired

Creation date in ISO 8601 format

Example: 2026-03-03T17:25:53.312Z

updateDatestringRequired

Last update date in ISO 8601 format

Example: 2026-03-03T17:25:53.312Z

uuidstringRequired

Unique universal identifier

Example: 9db028d2-03ad-4d49-a178-cf4b67f8c147

ownerstringRequired

DID of the theme owner

Example: did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599

namestringRequired

Theme name

Example: Theme name

401

Unauthorized request.

application/json

403

Forbidden

application/json

404

Theme not found.

application/json

422

Invalid theme ID.

application/json

500

Internal server error.

application/json

put/themes/{themeId}

PUT /api/v1/themes/{themeId} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 437

{
  "id": "69aeb71ef8c5b278e3bab4e5",
  "createDate": "2026-03-03T17:25:53.312Z",
  "updateDate": "2026-03-03T17:25:53.312Z",
  "uuid": "9db028d2-03ad-4d49-a178-cf4b67f8c147",
  "owner": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
  "name": "Theme name",
  "rules": [
    {
      "description": "Description",
      "text": "#000000",
      "background": "#000000",
      "border": "#000000",
      "shape": "0",
      "borderWidth": "2px",
      "filterType": "type",
      "filterValue": "text"
    }
  ]
}

{
  "createDate": "2026-03-25T14:36:51.320Z",
  "updateDate": "2026-03-25T14:36:51.320Z",
  "uuid": "71725b88-1801-4ab6-b672-3c133cd73e89",
  "name": "Test Theme",
  "owner": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
  "rules": [
    {
      "description": "Container style",
      "text": "#ffffff",
      "background": "#1a1a2e",
      "border": "#16213e",
      "shape": "0",
      "borderWidth": "2px",
      "filterType": "type",
      "filterValue": "interfaceContainerBlock"
    }
  ],
  "id": "69c3f303810b639b34bae861"
}

Deletes the theme.

delete

Deletes the theme with the provided theme ID. Only users with the Standard Registry role are allowed to make the request.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

themeIdstringRequired

Theme Identifier

Example: 69aeb71ef8c5b278e3bab4e5

Responses

200

Successful operation.

application/json

booleanOptional

401

Unauthorized request.

application/json

403

Forbidden

application/json

422

Invalid theme ID.

application/json

500

Internal server error.

application/json

delete/themes/{themeId}

DELETE /api/v1/themes/{themeId} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

true

Imports new theme from a zip file.

post

Imports new theme from the provided zip file into the local DB. Only users with the Standard Registry role are allowed to make the request.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

stringOptional

Responses

201

Successful operation.

application/json

idstringRequired

Internal database identifier

Example: 69aeb71ef8c5b278e3bab4e5

createDatestringRequired

Creation date in ISO 8601 format

Example: 2026-03-03T17:25:53.312Z

updateDatestringRequired

Last update date in ISO 8601 format

Example: 2026-03-03T17:25:53.312Z

uuidstringRequired

Unique universal identifier

Example: 9db028d2-03ad-4d49-a178-cf4b67f8c147

ownerstringRequired

DID of the theme owner

Example: did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599

namestringRequired

Theme name

Example: Theme name

401

Unauthorized request.

application/json

403

Forbidden

application/json

500

Internal server error.

application/json

post/themes/import/file

POST /api/v1/themes/import/file HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 6

"text"

{
  "createDate": "2026-03-25T14:36:51.320Z",
  "updateDate": "2026-03-25T14:36:51.320Z",
  "uuid": "71725b88-1801-4ab6-b672-3c133cd73e89",
  "name": "Test Theme",
  "owner": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
  "rules": [
    {
      "description": "Container style",
      "text": "#ffffff",
      "background": "#1a1a2e",
      "border": "#16213e",
      "shape": "0",
      "borderWidth": "2px",
      "filterType": "type",
      "filterValue": "interfaceContainerBlock"
    }
  ],
  "id": "69c3f303810b639b34bae861"
}

Returns a zip file containing the theme.

get

Returns a zip file containing the theme. Only users with the Standard Registry role are allowed to make the request.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

themeIdstringRequired

Theme Identifier

Example: 69aeb71ef8c5b278e3bab4e5

Responses

200

Successful operation. Response zip file.

application/zip

string · binaryOptional

401

Unauthorized request.

application/zip

403

Forbidden

application/zip

500

Internal server error.

application/zip

get/themes/{themeId}/export/file

GET /api/v1/themes/{themeId}/export/file HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

binary