Themes

Retrieve a list of themes

GET

https://partner-api.monta.com

/api/v1/themes

Required scope: themes:read
Organization authorization: supported

Retrieve a list of themes › query Parameters

page

integer · int32

page number to retrieve (starts with 0)

Default: 0

perPage

integer · int32

number of items per page (between 1 and 100, default 10)

Default: 10

operatorId

integer | null · int64

Allows filtering themes by operatorId.
*Note:*The operatorId must be in the consumer’s operatorIds or, if empty, belong to the organization’s sub-operators.

Example: 1

Retrieve a list of themes › Responses

List of themes that match the criteria

OffsetBasedResponse_64

ThemeDto[] · required

MontaPage.Meta · required

Create a theme

POST

https://partner-api.monta.com

/api/v1/themes

Creates a new theme for the operator. Image fields accept base64-encoded data URLs (data:image/png;base64,...); supported MIME types are image/png, image/jpeg, image/svg+xml; maximum 4 MB per image.
Required scope: themes:write
Organization authorization: supported

Create a theme › Request Body

name

string · minLength: 1 · required

Name of the theme

Example: Brand A

app_primary_color

string · minLength: 1 · required

Primary colour for the app

Example: #1A1A1A

app_secondary_color

string · minLength: 1 · required

Secondary colour for the app

Example: #FFFFFF

portal_primary_color

string · minLength: 1 · required

Primary colour for the portal

Example: #1A1A1A

portal_secondary_color

string · minLength: 1 · required

Secondary colour for the portal

Example: #FFFFFF

app_image

string · minLength: 1 · maxLength: 6000000 · required

App logo as a base64-encoded data URL. Allowed MIME types: image/png, image/jpeg, image/svg+xml. Max 4 MB.

Example: data:image/png;base64,iVBORw0KGgo...

portal_image

string · minLength: 1 · maxLength: 6000000 · required

Portal logo as a base64-encoded data URL.

Example: data:image/png;base64,iVBORw0KGgo...

portal_fav_icon

string · minLength: 1 · maxLength: 6000000 · required

Portal favicon as a base64-encoded data URL.

Example: data:image/png;base64,iVBORw0KGgo...

default

boolean

sidebar_theming_enabled

boolean

Whether sidebar theming is enabled

Example: false

Create a theme › Responses

Created theme

name

string · required

Name of the theme

Example: Custom Theme

title

string · required

Title of the theme formatted with operator name

Example: Operator Custom Theme

primaryColor

string · required

Primary color in HEX format

Example: #FF5733

secondaryColor

string · required

Secondary color in HEX format

Example: #FF5733

logoUrl

string · required

Url of the logo image

Example: https://example.com/logo.png

favIconUrl

string · required

Url of the favicon image

Example: https://example.com/favicon.png

object · required

Operator associated with the theme

id

integer · int64

Unique identifier of the theme

Example: 1

POST/api/v1/themes

curl https://partner-api.monta.com/api/v1/themes \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "name": "Brand A",
  "default": true,
  "sidebar_theming_enabled": false,
  "app_primary_color": "#1A1A1A",
  "app_secondary_color": "#FFFFFF",
  "portal_primary_color": "#1A1A1A",
  "portal_secondary_color": "#FFFFFF",
  "app_image": "data:image/png;base64,iVBORw0KGgo...",
  "portal_image": "data:image/png;base64,iVBORw0KGgo...",
  "portal_fav_icon": "data:image/png;base64,iVBORw0KGgo..."
}'

Example Request Body

{
  "name": "Brand A",
  "default": true,
  "sidebar_theming_enabled": false,
  "app_primary_color": "#1A1A1A",
  "app_secondary_color": "#FFFFFF",
  "portal_primary_color": "#1A1A1A",
  "portal_secondary_color": "#FFFFFF",
  "app_image": "data:image/png;base64,iVBORw0KGgo...",
  "portal_image": "data:image/png;base64,iVBORw0KGgo...",
  "portal_fav_icon": "data:image/png;base64,iVBORw0KGgo..."
}

json

Example Responses

{
  "id": 1,
  "name": "Custom Theme",
  "title": "Operator Custom Theme",
  "primaryColor": "#FF5733",
  "secondaryColor": "#FF5733",
  "logoUrl": "https://example.com/logo.png",
  "favIconUrl": "https://example.com/favicon.png",
  "operator": {
    "id": 1,
    "identifier": "operator-1",
    "themingEnabled": true
  }
}

json

application/json

Retrieve a single theme

GET

https://partner-api.monta.com

/api/v1/themes/{themeId}

Required scope: themes:read
Organization authorization: supported

Retrieve a single theme › path Parameters

themeId

integer · int64 · required

Retrieve a single theme › Responses

Theme with provided id

name

string · required

Name of the theme

Example: Custom Theme

title

string · required

Title of the theme formatted with operator name

Example: Operator Custom Theme

primaryColor

string · required

Primary color in HEX format

Example: #FF5733

secondaryColor

string · required

Secondary color in HEX format

Example: #FF5733

logoUrl

string · required

Url of the logo image

Example: https://example.com/logo.png

favIconUrl

string · required

Url of the favicon image

Example: https://example.com/favicon.png

object · required

Operator associated with the theme

id

integer · int64

Unique identifier of the theme

Example: 1

Update a theme

PUT

https://partner-api.monta.com

/api/v1/themes/{themeId}

Partially updates a theme. Only provided fields are changed; image fields, when provided, must be base64-encoded data URLs and replace the corresponding stored asset.
Required scope: themes:write
Organization authorization: supported

Update a theme › path Parameters

themeId

integer · int64 · required

Update a theme › Request Body

name

string | null

Name of the theme

default

boolean | null

sidebar_theming_enabled

boolean | null

Whether sidebar theming is enabled

app_primary_color

string | null

Primary colour for the app

app_secondary_color

string | null

Secondary colour for the app

portal_primary_color

string | null

Primary colour for the portal

portal_secondary_color

string | null

Secondary colour for the portal

app_image

string | null · maxLength: 6000000

Replacement app logo as a base64-encoded data URL

portal_image

string | null · maxLength: 6000000

Replacement portal logo as a base64-encoded data URL

portal_fav_icon

string | null · maxLength: 6000000

Replacement portal favicon as a base64-encoded data URL

Update a theme › Responses

Updated theme

name

string · required

Name of the theme

Example: Custom Theme

title

string · required

Title of the theme formatted with operator name

Example: Operator Custom Theme

primaryColor

string · required

Primary color in HEX format

Example: #FF5733

secondaryColor

string · required

Secondary color in HEX format

Example: #FF5733

logoUrl

string · required

Url of the logo image

Example: https://example.com/logo.png

favIconUrl

string · required

Url of the favicon image

Example: https://example.com/favicon.png

object · required

Operator associated with the theme

id

integer · int64

Unique identifier of the theme

Example: 1

PUT/api/v1/themes/{themeId}

curl https://partner-api.monta.com/api/v1/themes/:themeId \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "name": "name",
  "default": true,
  "sidebar_theming_enabled": true,
  "app_primary_color": "app_primary_color",
  "app_secondary_color": "app_secondary_color",
  "portal_primary_color": "portal_primary_color",
  "portal_secondary_color": "portal_secondary_color",
  "app_image": "app_image",
  "portal_image": "portal_image",
  "portal_fav_icon": "portal_fav_icon"
}'

Example Request Body

{
  "name": "name",
  "default": true,
  "sidebar_theming_enabled": true,
  "app_primary_color": "app_primary_color",
  "app_secondary_color": "app_secondary_color",
  "portal_primary_color": "portal_primary_color",
  "portal_secondary_color": "portal_secondary_color",
  "app_image": "app_image",
  "portal_image": "portal_image",
  "portal_fav_icon": "portal_fav_icon"
}

json

Example Responses

{
  "id": 1,
  "name": "Custom Theme",
  "title": "Operator Custom Theme",
  "primaryColor": "#FF5733",
  "secondaryColor": "#FF5733",
  "logoUrl": "https://example.com/logo.png",
  "favIconUrl": "https://example.com/favicon.png",
  "operator": {
    "id": 1,
    "identifier": "operator-1",
    "themingEnabled": true
  }
}

json

application/json

Delete a theme

DELETE

https://partner-api.monta.com

/api/v1/themes/{themeId}

Soft-deletes the theme.
Required scope: themes:delete
Organization authorization: supported

Delete a theme › path Parameters

themeId

integer · int64 · required

Delete a theme › Responses

Theme deleted

No data returned