Updating a theme

Update your Verify theme to change the look and feel of pages displayed in your applications on your tenant.

Before you begin

  1. Get an access token. See Managing themes.
  2. Download a theme with API.

About this task

Verify pages can be changed and customized for your company by updating the files in a theme.

Procedure

  1. Extract the compressed theme file from Download a theme with API and update the files for your Verify tenant.
  2. Create a compressed theme file with the same directory structure as the file that was downloaded in step 1 for your updated theme files.
  3. Upload the compressed theme file that contains your updates back to your tenant.
    curl -X PUT 'https://<tenant>/v1.0/branding/themes/<themeID>' --header 'Content-Type: multipart/form-data' --header 'Accept: application/json' -F 'configuration=@<JSON configuration file>'  -F 'files=@<update_theme_file>.zip' -H 'Authorization: Bearer <access_token>'
    where:
    <tenant>
    The fully qualified domain name that is assigned to your Verify subscription.
    <themeID>
    The theme identification name. See List the themes.
    <JSON configuration file>
    The theme registration configuration payload, a string-encoded JSON object. Example:
    {
    "name": "string",
    "description": "string (optional)",
    }
    <update_theme_file>
    A compressed theme file with the formatted theme structure used when registering or updating a theme.
    <access_token>
    The value of the access token you received in Managing themes.

Example

The following example updates the default theme for your Verify tenant, which applies to all applications.

curl -X PUT 'https://companyAppTest.verify.ibm.com/v1.0/branding/themes/default' --header 'Content-Type: multipart/form-data' --header 'Accept: application/json' -F 'configuration=@config.json'  -F 'files=@my_themes.zip' -H 'Authorization: Bearer JUHn05z35P4Kd9QaCLHFEyMGEbzeCOo0faBefI9w'

The next example updates a user-created theme on the tenant.

curl -X PUT 'https://companyAppTest.verify.ibm.com/v1.0/branding/themes/38d7387a-3b03-455d-b358-55ed497065e7' --header 'Content-Type: multipart/form-data' --header 'Accept: application/json' -F 'configuration=@config.json'  -F 'files=@my_themes.zip' -H 'Authorization: Bearer JUHn05z35P4Kd9QaCLHFEyMGEbzeCOo0faBefI9w'