Download a specific template file for a theme
Download a specific theme template file for your Verify tenant.
Before you begin
- Get an access token. See Managing themes.
- A theme ID is required to download a theme file. To find the theme ID, see List the themes.
About this task
Download a specific theme file to customize a specific Verify template on your tenant.
Procedure
Download a specific file for a theme with the following command.
curl -X GET -H "Authorization: Bearer <access_token>" <https://<tenant>/v1.0/branding/themes/<themeID>/<templatePath>> > <specific_template_filename.html> where:- <access_token>
- The value of the access token you received in Managing themes.
- <tenant>
- The fully qualified domain name that is assigned to your Verify subscription.
- <themeID>
-
The theme identification name. See List the themes.
- master
- The master theme is for reference. It cannot be modified. The master theme is used by Verify when no customizations are present.
- default
- The default theme is the theme for the overall Verify tenant. The default theme applies to all applications.
- <user created>
- A theme created by the user when following Register a new theme.
- <templatePath>
- Directory path and file name of the specific template file as found in the compressed theme file, for example, authentication/saml/error/default/routing_error.html.
- <specific_template_filename.html>
- The file name created on your system with the contents of the specific template file.
Results
A specific template file for a theme is returned to the current directory.
Example
To download a specific template file named routing_error.html for the theme ID of bb828385-e11c-4041-8474-eb95bdc2a35c on the companyAppTest.verify.ibm.com tenant, issue the following command:
curl -X GET -H "Authorization: Bearer m1KhswVeQy84CF4sAki88phTkpmnYtaDzWi26ASX" -H "Accept: application/octet-stream" https://companyAppTest.verify.ibm.com/v1.0/branding/themes/bb828385-e11c-4041-8474-eb95bdc2a35c/authentication/saml/error/default/routing_error.html > routing_error.html