Theme

The Theme module makes theme management more efficient and effective. It allows you to view all theme pages, obtain details about specific theme pages, check the current app theme, and preview and test themes before applying them live.

Extension Section

Oversee the extension sections in your application through the CLI. This includes obtaining draft extension sections, publishing extension sections, retrieving sections of extensions, and more.

Operations
GET
/service/platform/theme/v1.0/company/{company_id}/application/{application_id}/extension-section
# Get extension sections
GET

Get extension sections

Retrieve the list of extension sections for a given application in the specified company.
Requires application/themes/read access scope.
Parameters
company_id
integer
Required
The ID of the company
application_id
string
Required
The ID of the application
type
string
The type of the theme
company_mode
string
The mode of the company
Response
200
Successfully retrieved the list of extension sections.
Array of GetExtensionSectionRes
extension_id
string
bundle_name
string
organization_id
string
sections
array of object (ExtensionSection)
Array of ExtensionSection
label
string
name
string
props
array of object (PropExtension)
Array of PropExtension
id
string
label
string
type
string
info
string
blocks
array of object
assets
object (AssetsExtension)
AssetsExtension
js
string
css
string
status
string
type
string
created_at
string
| date-time
updated_at
string
| date-time
Examples
Parameters
company_id:
1
application_id:
"6399ba8924ab1be7c21314b5"
type:
"react"
company_mode:
"live"
GET
/service/platform/theme/v1.0/company/{company_id}/application/{application_id}/extension-section
Loading...
Response
Loading...

Page Mapper

Page Mapper is a feature which enables to dynamically set different page content on a single slug based on various attributes such as user, schedule and theme zones

Operations
GET
/service/platform/theme/v1.0/company/{company_id}/application/{application_id}/page-mapper-config
# Get Page Mapper Configuration
PUT
/service/platform/theme/v1.0/company/{company_id}/application/{application_id}/page-mapper-config
# Update Page Mapper Configuration
GET

Get Page Mapper Configuration

Retrieve the page mapper configuration for a specific application within a company.
Requires application/themes/read access scope.
Parameters
company_id
string
Required
Numeric ID allotted to a business account on Fynd Platform.
application_id
string
Required
ID of the application within the business account.
Response
200
Success. Page Mapper information returned.
PageMapperSchema
_id
string
Unique identifier for the resource
application_id
string
Identifier of the application to which this resource belongs
created_at
string
| date-time
Timestamp when the resource was created
enabled
boolean
Flag indicating whether the resource is enabled or disabled
updated_at
string
| date-time
Timestamp when the resource was last updated
Examples
Parameters
company_id:
"1"
application_id:
"66500a1f0e79b842c8f17c21"
GET
/service/platform/theme/v1.0/company/{company_id}/application/{application_id}/page-mapper-config
Loading...
Response
Loading...
PUT

Update Page Mapper Configuration

Update the `enabled` status of the page mapper for a specific application.
Requires application/themes/write access scope.
Parameters
company_id
string
Required
Numeric ID allotted to a business account on Fynd Platform.
application_id
string
Required
ID of the application within the business account.
Request body
enabled
boolean
Required
Whether the Page Mapper is enabled or disabled
Response
200
Success. Updated Page Mapper info returned.
PageMapperSchema
_id
string
Unique identifier for the resource
application_id
string
Identifier of the application to which this resource belongs
created_at
string
| date-time
Timestamp when the resource was created
enabled
boolean
Flag indicating whether the resource is enabled or disabled
updated_at
string
| date-time
Timestamp when the resource was last updated
Examples
Parameters
company_id:
"1"
application_id:
"66500a2a7b442d2e7a9a9e14"
body:
body
PUT
/service/platform/theme/v1.0/company/{company_id}/application/{application_id}/page-mapper-config
Loading...
Response
Loading...

Sales Channel Theme

Theme API provides a comprehensive set of tools to efficiently manage assets and global configurations for web themes. With these APIs, developers can seamlessly handle essential asset details such as JavaScript (JS) and CSS bundle URLs, along with image URLs, crucial for creating visually appealing themes. Moreover, the APIs empower sales channel users to contribute by adding data for global configurations, including color palettes and other theme global settings.

Operations
GET
/service/platform/theme/v2.0/company/{company_id}/application/{application_id}/fonts
# List theme fonts
PATCH
/service/platform/theme/v2.0/company/{company_id}/application/{application_id}/{theme_id}/name
# Update theme name
POST
/service/platform/theme/v2.0/company/{company_id}/application/{application_id}
# Get Create theme
GET
/service/platform/theme/v2.0/company/{company_id}/application/{application_id}
# Get applied theme
GET
/service/platform/theme/v2.0/company/{company_id}/application/{application_id}/slug/{slug_name}/latest
# Get latest version of theme by slug.
GET

List theme fonts

Retrieve a list of available fonts that can be used by themes in the platform.
Requires company/settings/read access scope.
Parameters
company_id
integer
Required
Numeric ID allotted to a business account on Fynd Platform.
application_id
string
Required
Alphanumeric ID allotted to an application created within a business account.
Response
200
Success. Refer `FontsSchema` for more details.
FontsSchema
items
array of object
kind
string
Examples
Parameters
company_id:
123
application_id:
"000000000000000000000001"
GET
/service/platform/theme/v2.0/company/{company_id}/application/{application_id}/fonts
Loading...
Response
Loading...
PATCH

Update theme name

Modify the name of the draft theme by theme Id.
Requires application/themes/write access scope.
Parameters
company_id
integer
Required
The ID of the company.
application_id
string
Required
The ID of the application.
theme_id
string
Required
The ID of the theme to be updated.
Request body
name
string
The new name of the theme.
Response
200
400
Theme name updated successfully.
ThemesSchema
font
object (Font)
Font
variants
object (FontVariants)
FontVariants
light
object (FontVariant)
FontVariant
name
string
The name of the font variant
file
string
The URL of the font file
regular
object (FontVariant)
FontVariant
name
string
The name of the font variant
file
string
The URL of the font file
medium
object (FontVariant)
FontVariant
name
string
The name of the font variant
file
string
The URL of the font file
semi_bold
object (FontVariant)
FontVariant
name
string
The name of the font variant
file
string
The URL of the font file
bold
object (FontVariant)
FontVariant
name
string
The name of the font variant
file
string
The URL of the font file
family
string
The font family
config
object (Config)
Config
current
string
The current configuration
list
array of object (ThemeConfiguration)
A list of configurations
Array of ThemeConfiguration
name
string
The name of the configuration
global_config
object
page
array of object (ThemeConfigListPage)
An array of pages
Array of ThemeConfigListPage
page
string
Name of the page
settings
object (ThemeConfigListPageSettingsProps)
ThemeConfigListPageSettingsProps
props
object
global_schema
object (GlobalSchema)
GlobalSchema
props
array of object
preset
object
An Object of default theme configurations
applied
boolean
Whether the theme has been applied or not
is_private
boolean
Whether the theme is private or not
tags
array of string
An array of tags associated with the theme
_id
string
The unique identifier of the theme
application_id
string
The ID of the application
marketplace_theme_id
string
The ID of the theme in the marketplace
meta
object (ThemeMeta)
ThemeMeta
payment
object (ThemePayment)
ThemePayment
is_paid
boolean
Whether the theme is a paid theme.
amount
number
The amount to be paid for the theme.
description
string
The description of the theme
industry
array of string
An array of industries associated with the theme
release
object (Release)
Release
notes
string
The release notes of the theme
version
string
The version of the theme
images
object (Images)
Images
desktop
string
The URL of the desktop image
mobile
string
The URL of the mobile image
slug
string
The slug of the theme
name
string
The name of the theme
name
string
The name of the theme
template_theme_id
string
The ID of the template theme
version
string
The version of the theme
styles
object
The styles associated with the theme
created_at
string
| date-time
The creation timestamp of the theme
updated_at
string
| date-time
The last update timestamp of the theme
global_sections
array of object
assets
object (Assets)
Assets
umd_js
object (UMDJs)
UMDJs
link
string
links
array of string
An array of pages
common_js
object (CommonJS)
CommonJS
link
string
css
object (CSS)
CSS
link
string
links
array of string
available_sections
array of object (SectionItem)
Available sections information
Array of SectionItem
props
array of object
blocks
array of object
Blocks
name
string
Name of the section
preset
object (SectionPreset)
SectionPreset
blocks
array of object (Block)
Array of Block
type
string
The type of the block.
name
string
The name of the block.
props
object (BlockProps)
BlockProps
image
object (ImagePickerProp)
ImagePickerProp
type
string
The type of the property.
value
string
The value of the image picker property.
slide_link
object (UrlProp)
UrlProp
type
string
The type of the property.
value
string
The value of the URL property.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
label
string
Label for the section
theme_type
string
Enum
company_id
number
The company id in which sales channel exists
src
string
applied_themes
array of object
Applied themes array
Examples
Parameters
company_id:
123
application_id:
"000000000000000000000001"
theme_id:
"000000000000000000000001"
body:
body
PATCH
/service/platform/theme/v2.0/company/{company_id}/application/{application_id}/{theme_id}/name
Loading...
Response
Loading...
POST

Get Create theme

Creating a new theme.
Requires application/themes/write access scope.
Parameters
company_id
integer
Required
The ID of the company
application_id
string
Required
The ID of the application
Request body
marketplace_theme_id
string
Theme id of the marketplace
Response
200
Successfully fetch the create theme
ThemesSchema
font
object (Font)
Font
variants
object (FontVariants)
FontVariants
light
object (FontVariant)
FontVariant
name
string
The name of the font variant
file
string
The URL of the font file
regular
object (FontVariant)
FontVariant
name
string
The name of the font variant
file
string
The URL of the font file
medium
object (FontVariant)
FontVariant
name
string
The name of the font variant
file
string
The URL of the font file
semi_bold
object (FontVariant)
FontVariant
name
string
The name of the font variant
file
string
The URL of the font file
bold
object (FontVariant)
FontVariant
name
string
The name of the font variant
file
string
The URL of the font file
family
string
The font family
config
object (Config)
Config
current
string
The current configuration
list
array of object (ThemeConfiguration)
A list of configurations
Array of ThemeConfiguration
name
string
The name of the configuration
global_config
object
page
array of object (ThemeConfigListPage)
An array of pages
Array of ThemeConfigListPage
page
string
Name of the page
settings
object (ThemeConfigListPageSettingsProps)
ThemeConfigListPageSettingsProps
props
object
global_schema
object (GlobalSchema)
GlobalSchema
props
array of object
preset
object
An Object of default theme configurations
applied
boolean
Whether the theme has been applied or not
is_private
boolean
Whether the theme is private or not
tags
array of string
An array of tags associated with the theme
_id
string
The unique identifier of the theme
application_id
string
The ID of the application
marketplace_theme_id
string
The ID of the theme in the marketplace
meta
object (ThemeMeta)
ThemeMeta
payment
object (ThemePayment)
ThemePayment
is_paid
boolean
Whether the theme is a paid theme.
amount
number
The amount to be paid for the theme.
description
string
The description of the theme
industry
array of string
An array of industries associated with the theme
release
object (Release)
Release
notes
string
The release notes of the theme
version
string
The version of the theme
images
object (Images)
Images
desktop
string
The URL of the desktop image
mobile
string
The URL of the mobile image
slug
string
The slug of the theme
name
string
The name of the theme
name
string
The name of the theme
template_theme_id
string
The ID of the template theme
version
string
The version of the theme
styles
object
The styles associated with the theme
created_at
string
| date-time
The creation timestamp of the theme
updated_at
string
| date-time
The last update timestamp of the theme
global_sections
array of object
assets
object (Assets)
Assets
umd_js
object (UMDJs)
UMDJs
link
string
links
array of string
An array of pages
common_js
object (CommonJS)
CommonJS
link
string
css
object (CSS)
CSS
link
string
links
array of string
available_sections
array of object (SectionItem)
Available sections information
Array of SectionItem
props
array of object
blocks
array of object
Blocks
name
string
Name of the section
preset
object (SectionPreset)
SectionPreset
blocks
array of object (Block)
Array of Block
type
string
The type of the block.
name
string
The name of the block.
props
object (BlockProps)
BlockProps
image
object (ImagePickerProp)
ImagePickerProp
type
string
The type of the property.
value
string
The value of the image picker property.
slide_link
object (UrlProp)
UrlProp
type
string
The type of the property.
value
string
The value of the URL property.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
label
string
Label for the section
theme_type
string
Enum
company_id
number
The company id in which sales channel exists
src
string
applied_themes
array of object
Applied themes array
Examples
Parameters
company_id:
19243
application_id:
"000000000000000000000001"
body:
body
POST
/service/platform/theme/v2.0/company/{company_id}/application/{application_id}
Loading...
Response
Loading...
GET

Get applied theme

Retrieve the currently applied theme of a sales channel using application Id.
Requires application/themes/write access scope.
Parameters
company_id
integer
Required
The ID of the company
application_id
string
Required
The ID of the application
Response
200
Successfully fetch the applied theme
ThemesSchema
font
object (Font)
Font
variants
object (FontVariants)
FontVariants
light
object (FontVariant)
FontVariant
name
string
The name of the font variant
file
string
The URL of the font file
regular
object (FontVariant)
FontVariant
name
string
The name of the font variant
file
string
The URL of the font file
medium
object (FontVariant)
FontVariant
name
string
The name of the font variant
file
string
The URL of the font file
semi_bold
object (FontVariant)
FontVariant
name
string
The name of the font variant
file
string
The URL of the font file
bold
object (FontVariant)
FontVariant
name
string
The name of the font variant
file
string
The URL of the font file
family
string
The font family
config
object (Config)
Config
current
string
The current configuration
list
array of object (ThemeConfiguration)
A list of configurations
Array of ThemeConfiguration
name
string
The name of the configuration
global_config
object
page
array of object (ThemeConfigListPage)
An array of pages
Array of ThemeConfigListPage
page
string
Name of the page
settings
object (ThemeConfigListPageSettingsProps)
ThemeConfigListPageSettingsProps
props
object
global_schema
object (GlobalSchema)
GlobalSchema
props
array of object
preset
object
An Object of default theme configurations
applied
boolean
Whether the theme has been applied or not
is_private
boolean
Whether the theme is private or not
tags
array of string
An array of tags associated with the theme
_id
string
The unique identifier of the theme
application_id
string
The ID of the application
marketplace_theme_id
string
The ID of the theme in the marketplace
meta
object (ThemeMeta)
ThemeMeta
payment
object (ThemePayment)
ThemePayment
is_paid
boolean
Whether the theme is a paid theme.
amount
number
The amount to be paid for the theme.
description
string
The description of the theme
industry
array of string
An array of industries associated with the theme
release
object (Release)
Release
notes
string
The release notes of the theme
version
string
The version of the theme
images
object (Images)
Images
desktop
string
The URL of the desktop image
mobile
string
The URL of the mobile image
slug
string
The slug of the theme
name
string
The name of the theme
name
string
The name of the theme
template_theme_id
string
The ID of the template theme
version
string
The version of the theme
styles
object
The styles associated with the theme
created_at
string
| date-time
The creation timestamp of the theme
updated_at
string
| date-time
The last update timestamp of the theme
global_sections
array of object
assets
object (Assets)
Assets
umd_js
object (UMDJs)
UMDJs
link
string
links
array of string
An array of pages
common_js
object (CommonJS)
CommonJS
link
string
css
object (CSS)
CSS
link
string
links
array of string
available_sections
array of object (SectionItem)
Available sections information
Array of SectionItem
props
array of object
blocks
array of object
Blocks
name
string
Name of the section
preset
object (SectionPreset)
SectionPreset
blocks
array of object (Block)
Array of Block
type
string
The type of the block.
name
string
The name of the block.
props
object (BlockProps)
BlockProps
image
object (ImagePickerProp)
ImagePickerProp
type
string
The type of the property.
value
string
The value of the image picker property.
slide_link
object (UrlProp)
UrlProp
type
string
The type of the property.
value
string
The value of the URL property.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
label
string
Label for the section
theme_type
string
Enum
company_id
number
The company id in which sales channel exists
src
string
applied_themes
array of object
Applied themes array
Examples
Parameters
company_id:
19243
application_id:
"000000000000000000000001"
GET
/service/platform/theme/v2.0/company/{company_id}/application/{application_id}
Loading...
Response
Loading...
GET

Get latest version of theme by slug.

Retrieve the most recent version of a theme using its slug.
Requires application/themes/read access scope.
Parameters
application_id
string
Required
The ID of the application
company_id
integer
Required
The ID of the company
slug_name
string
Required
Slug of theme
Response
200
Successful operation
Array of MarketplaceTheme
_id
string
Theme ID
payment
object (PaymentInfo)
PaymentInfo
is_paid
boolean
Indicates if the theme is paid
amount
number
Amount of payment
contact
object (ContactInfo)
ContactInfo
developer_contact
array of string
Developer contact information
seller_contact
string
Seller contact information
industry
array of string
Industries the theme is suitable for
is_update
boolean
Indicates if the theme is an update
is_default
boolean
Indicates if the theme is a default theme
name
string
Theme name
tagline
string
Theme tagline
description
string
Theme description
catalog_size
object (CatalogSize)
CatalogSize
min
integer
Minimum catalog size
max
integer
Maximum catalog size
images
object (MarketplaceThemeImages)
MarketplaceThemeImages
desktop
string
Desktop theme image URL
mobile
string
Mobile theme image URL
carousel
array of object (CarouselItem)
Array of CarouselItem
desktop
string
Desktop carousel image URL
mobile
string
Mobile carousel image URL
src
string
Theme source URL
explore
object (ExploreInfo)
ExploreInfo
title
string
Explore feature title
description
string
Explore feature description
features
array of object (Feature)
Array of Feature
category
string
Feature category
list
array of object (FeatureItem)
Array of FeatureItem
label
string
Feature properties
description
string
Feature description
highlights
array of object (Highlight)
Array of Highlight
title
string
Highlight title
description
string
Highlight description
image
string
Highlight image URL
variations
array of object (Variation)
Array of Variation
name
string
Variation name
color
string
Variation color
demo_url
string
Variation demo URL
images
object (MarketplaceThemeImages)
MarketplaceThemeImages
desktop
string
Desktop theme image URL
mobile
string
Mobile theme image URL
documentation
object (Documentation)
Documentation
notes
string
Documentation notes
url
string
Documentation URL
status
string
Theme status
step
integer
Theme step
comments
object (Comments)
Comments
developer_remark
string
Developer remark
reviewer_feedback
string
Reviewer feedback
release
object (Release)
Release
notes
string
The release notes of the theme
version
string
The version of the theme
slug
string
Theme slug
organization_id
string
Organization ID
user_id
string
User ID
created_at
string
| date-time
Theme creation timestamp
updated_at
string
| date-time
Theme update timestamp
template_theme_id
string
Template theme ID
theme_type
string
Theme type
Examples
Parameters
application_id:
"000000000000000000000001"
company_id:
123
slug_name:
"astra"
GET
/service/platform/theme/v2.0/company/{company_id}/application/{application_id}/slug/{slug_name}/latest
Loading...
Response
Loading...

Theme Page

Theme Pages API is a tool for developers to efficiently create dynamic and customizable web pages across various platforms. It offers essential features such as section filtering based on criteria like delivery zones, time scheduler, and type of platforms, it enables developers to configure reusable sections with multiple elements using blocks, fostering creativity and flexibility in design. Moreover, it provides functionality for managing the SEO content of a page. For instance, developers can easily design a homepage with a featured products section and a promotional banner, customizing the content and layout as needed. They can implement filtering based on delivery zones and time scheduler to cater to specific audiences effectively. Ultimately, the UI Theme Pages API empowers developers to craft engaging and optimized user experiences that resonate across platforms.

Operations
POST
/service/platform/theme/v1.0/company/{company_id}/application/{application_id}/page-mapper
# Create a Page Mapping
PUT
/service/platform/theme/v1.0/company/{company_id}/application/{application_id}/page-mapper/{page_value}
# Update a Page Mapping
DEL
/service/platform/theme/v1.0/company/{company_id}/application/{application_id}/page-mapper/{page_value}
# Delete a Page Mapping
POST

Create a Page Mapping

Map a slug to a page content
Requires application/themes/write access scope.
Parameters
company_id
integer
Required
Company ID
application_id
string
Required
Application ID
Request body
fallback
string
Nullable
page
string
slug
string
filter
object (PageMapperFilterConfiguration)
PageMapperFilterConfiguration
platform
object (PageMapperPlatformFilter)
PageMapperPlatformFilter
ios
boolean
android
boolean
web
boolean
user
object (PageMapperUserFilter)
PageMapperUserFilter
user_type
string
Enum
schedule
object (PageMapperScheduleFilter)
PageMapperScheduleFilter
start
string
| date-time
end
string
| date-time
Response
200
400
Success
PageMapperResponseSchema
message
string
Examples
Parameters
company_id:
882
application_id:
"6640f9f1e5e7a7a654e2a8d2"
body:
body
POST
/service/platform/theme/v1.0/company/{company_id}/application/{application_id}/page-mapper
Loading...
Response
Loading...
PUT

Update a Page Mapping

Update page mapping for a page
Requires application/themes/write access scope.
Parameters
company_id
integer
Required
Company ID
application_id
string
Required
Application ID
page_value
string
Required
Value of Page
Request body
fallback
string
Nullable
slug
string
filter
object (PageMapperFilterConfiguration)
PageMapperFilterConfiguration
platform
object (PageMapperPlatformFilter)
PageMapperPlatformFilter
ios
boolean
android
boolean
web
boolean
user
object (PageMapperUserFilter)
PageMapperUserFilter
user_type
string
Enum
schedule
object (PageMapperScheduleFilter)
PageMapperScheduleFilter
start
string
| date-time
end
string
| date-time
Response
200
400
Success
PageMapperResponseSchema
message
string
Examples
Parameters
company_id:
882
application_id:
"6640f9f1e5e7a7a654e2a8d2"
page_value:
"to-modify-page-for-page-mapping-1750065503244"
body:
body
PUT
/service/platform/theme/v1.0/company/{company_id}/application/{application_id}/page-mapper/{page_value}
Loading...
Response
Loading...
DEL

Delete a Page Mapping

Delete page mapping for a page
Requires application/themes/write access scope.
Parameters
company_id
integer
Required
Company ID
application_id
string
Required
Application ID
page_value
string
Required
Value of Page
Response
200
400
Success
PageMapperResponseSchema
message
string
Examples
Parameters
company_id:
882
application_id:
"6640f9f1e5e7a7a654e2a8d2"
page_value:
"to-delete-page-for-page-mapping"
DEL
/service/platform/theme/v1.0/company/{company_id}/application/{application_id}/page-mapper/{page_value}
Loading...
Response
Loading...