article Qlik Cloud: How to Export apps from Managed spaces or unpublish an app with the REST API or Qlik-CLI in Official Support Articles

Qlik Cloud: How to Export apps from Managed spaces or unpublish an app with the REST API or Qlik-CLI

Sonja_Bauernfeind — Mon, 05 Feb 2024 09:24:58 GMT

Qlik Cloud has a built-in method to export apps from your managed spaces, along with APIs available which allow for automation.

Content:

Export apps from Managed spaces (native method)

This is the recommended method.

As of the 30th of January 2024, Qlik Cloud has introduced the functionality to Export apps from Managed Spaces.

Space Owner and users with the "Can Manage" role, can now export Qlik Cloud apps from Managed Spaces.

These apps can only be exported without data. Storytelling is not exported.

This possibility allows you to re-establish a parent - child relation of your source and published apps, in case the source app was accidentally deleted.

For more information, see:

Export apps using the Rest API

You can also export the app from a managed space without data through the REST API or Qlik Cli in a supported way.

These apps can only be exported without data, even if the NoData parameter is not set to true. Storytelling is not exported.

Method One: REST APIs

Requirements:

PowerShell
API keys enabled
The App ID
Your tenant URL

$hdrs = @{}
$hdrs.Add("Authorization","Bearer eyJhbGciOiJFUzM4NCIsImtpZCI6IjUzYj...VJaO0zSKZs7Q")
$tenanturl =  "https://yourtenant.ap.qlikcloud.com"
$appid = "7972e3ae-df5c-4ed3-81f4-e2220d76972d"
$url = $tenanturl+"/api/v1/apps/"+$appid+"/export?NoData=true"
 
$output = "C:\temp\MyExportedApp.qvf"
$firstcall=Invoke-WebRequest -Uri $url -Method Post -Headers $hdrs
 
$url2= $tenanturl+$firstcall.Headers.Location
echo $url2
Invoke-RestMethod -Uri $url2 -Method Get -Headers $hdrs -ContentType 'multipart/form-data' -OutFile $output

Reference:

Exports a specific app | Qlik Developer

Method Two: Qlik-Cli:

qlik app export 7972e3ae-df5c-4ed3-81f4-e2220d76972d --NoData > C:\temp\MyExportedApp.qvf

Reference:

app export | Qlik Developer

Unpublish an app with the REST API

Alternatively, an app can be unpublished from a Managed space and obtained for editing. This method maintains data, including storytelling.

Use this method at your own risk. Direct API calls make changes which bypass safety nets and the end result can lead to unexpected results.

Requirements:

PowerShell
API keys enabled
The App ID
Your tenant URL

Method One: REST APIs

This will move the app from a Management Space to your Personal space with the REST API.

Create an API key to perform the call. First of all. See https://qlik.dev/tutorials/generate-your-first-api-key

Using PowerShell, execute the following:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

$body='{"spaceId":""}'
$hdrs = @{}
$hdrs.Add("Authorization","Bearer eyJhbGciOiJM4ImtpZCI6IjBkZmQ5YzM2LTcy...YLmG54QLpd")
$hdrs.Add("content-type","application/json")
$url = "https://yourtenant.eu.qlikcloud.com/api/v1/apps/APPID/space"
Invoke-RestMethod -Uri $url -Method Put -Headers $hdrs -Body $body

Replace:

eyJhbGciOiJM4ImtpZCI6IjBkZmQ5YzM2LTcy...YLmG54QLpd with the API key you've generated
yourtenant.eu.qlikcloud.com with your tenant URL
APPID with your app ID

Tip: Get the App ID directly from the hub URL when you have the App open.

After the command is executed, the App will be moved to your personal space. This operation will retain bookmarks and sheets, though not their original owners.

Troubleshooting:

See following article if any TLS/SLL error are output when running the PowerShell script:
Qlik Sense API: Could not create secure SSL/TLS channel (Powershell)

Method Two: Qlik-Cli

This will move the app from a Management Space to your Personal space with the REST API, wrapped in the QLIK-CLI.

Alternatively, if qlik-cli is installed, the following commands can be used. In the code, replace APPID with the correct one (e.g. 68aae8b0-3770-435d-951d-7b97469fb78b).

Set the qlik-cli user as the owner (this is necessary if you don't want the app to go the original owner's personal space, in case they have left the company):
qlik app owner APPID
Move the app to the owner's personal space:
qlik app space update APPID
(Optional) once moved to the personal space, create a duplicate (to use as the new source app), and put back the original app in the original space. This way, all the dependencies and links to the published app will be kept:
qlik app space update APPID --spaceId SPACEID

The admin using the qlik-cli commands will need to have full permissions on the Managed space that hosts the app.

Use this method at your own risk. The direct API calls used in this workaround make changes which bypass safety nets and the end result can lead to unexpected results.

Re: Qlik Sense Enterprise SaaS: Unpublish an app with the REST API (PowerShell) or Qlik-Cli

Ken_T — Thu, 02 Mar 2023 16:39:12 GMT

thank you for documenting this workaround!

Re: Qlik Sense Enterprise SaaS: Unpublish an app with the REST API (PowerShell) or Qlik-Cli

rduregger — Thu, 20 Apr 2023 17:57:47 GMT

When I try this via method 1, I receive a 403 (Forbidden) response. I've double-checked my API key, app ID, and tenant URL. Are there additional headers I might need to include for authentication?

Re: Qlik Sense Enterprise SaaS: Unpublish an app with the REST API (PowerShell) or Qlik-Cli

Sonja_Bauernfeind — Tue, 25 Apr 2023 08:23:59 GMT

Hello @rduregger

I recommend posting your query directly in our API and Extension forum, where our active user base and support agents can assist you.

All the best,
Sonja

Re: Qlik Sense Enterprise SaaS: Unpublish an app with the REST API (PowerShell) or Qlik-Cli

sten_lomme — Wed, 07 Jun 2023 08:21:49 GMT

Shouldn't this feature be part of native Qlik SaaS solution? Is there any plans on including this in the platform?

Re: Qlik Sense Enterprise SaaS: Unpublish an app with the REST API (PowerShell) or Qlik-Cli

Sonja_Bauernfeind — Wed, 07 Jun 2023 08:59:06 GMT

Hello @sten_lomme

I recommend raising your interest in this idea in our Ideation app! This helps our product team see the features most requested by our customers and prioritise accordingly.

Here's the link to the app: Ideation

All the best,
Sonja

Re: Qlik Cloud: Unpublish an app with the REST API (PowerShell) or Qlik-Cli

jelzo_nl — Wed, 26 Jul 2023 14:37:57 GMT

This should be a console function

Users migrating from Sense Enterprise are used to deleting apps from their personal space and duplicating published apps from streams. In Sense SaaS, this will result in a 'lock out', where you cannot update the app anymore. This scenario is not uncommon and tenant admins should have this function availlable in the console.

Please upvote this idea to add this function to the development roadmap as soon as possible:
https://community.qlik.com/t5/Suggest-an-Idea/Qlik-Sense-SaaS-Duplicate-Export-App-from-Managed-Space/idi-p/1779701

Method 3: Using Qlik Automation

You can also unpublish using Qlik Automation. This will move the app back to the owners personal space.

1. Create a new API key ({apiKey}).
2. Create the automation flow as shown below.
3. Add the app id to the appId variable
4. Create a new connection type='httpheader', authentication_name='Authorization', api_key='Bearer {apiKey}', base_url='{tenantId}.{region}.qlikcloud.com/api/v1/'
5. Run the automation
Unpublish app from managed space using Qlik Automation

Re: Qlik Cloud: Unpublish an app with the REST API (PowerShell) or Qlik-Cli

Sonja_Bauernfeind — Thu, 27 Jul 2023 08:23:03 GMT

Hello, @jelzo_nl The old ideation system is no longer monitored by Qlik.

Please vote on and refer to the new system we implemented a few months ago. This is the idea you referenced: Qlik Sense SaaS - Duplicate/Export App from Managed Space

(If you receive a login error, you may need to log in directly to the app first.)

Re: Qlik Cloud: Unpublish an app with the REST API (PowerShell) or Qlik-Cli

sten_lomme — Mon, 31 Jul 2023 07:24:05 GMT

@sOnO login to new ideation system does not work. Just redirects to Pendo login. But no luck.

Re: Qlik Cloud: Unpublish an app with the REST API (PowerShell) or Qlik-Cli

Sonja_Bauernfeind — Mon, 31 Jul 2023 07:31:00 GMT

Hello @sten_lomme

I hope I have a workaround for you for this.

First, go to the Ideation page on Qlik community and click the card at the top with the link "Suggest Features" (screenshot attached). This will authenticate you into the portal. Then, you can exit it and then use the app links we sent above.

All the best,
Sonja

Re: Qlik Cloud: Unpublish an app with the REST API (PowerShell) or Qlik-Cli

sten_lomme — Mon, 31 Jul 2023 07:34:21 GMT

@Sonja_Bauernfeind That did the trick. Not very intuitive, though.

Re: Qlik Cloud: Unpublish an app with the REST API (PowerShell) or Qlik-Cli

Sonja_Bauernfeind — Mon, 31 Jul 2023 07:54:09 GMT

Hello @sten_lomme Glad this worked!

I am aware that our Ideation team is working on having the process improved, meaning you should be able to log in seamlessly whenever you click any link in the future.

All the best,
Sonja

Re: Qlik Cloud: Unpublish an app with the REST API (PowerShell) or Qlik-Cli

mgranillo — Fri, 05 Jan 2024 18:05:40 GMT

@Sonja_Bauernfeind do you know if any of these methods keep the personal sheets for all users? Its typical for us to have a few hundred unpublished personal sheets created by our users. I tested the automation method and lost the personal sheets.

Re: Qlik Cloud: Unpublish an app with the REST API (PowerShell) or Qlik-Cli

Sonja_Bauernfeind — Mon, 08 Jan 2024 11:12:47 GMT

Hello @mgranillo

This method is only meant to be used as a workaround if the original app has been lost and will bypass safety nets. It is specific to the published app and published content. I will reach out internally if we have anything on hand regarding personal sheets, but I believe that I will need to redirect the question to our API forum.

Will get back to you as soon as possible.

All the best,
Sonja

Re: Qlik Cloud: Unpublish an app with the REST API (PowerShell) or Qlik-Cli

Daniele_Purrone — Mon, 08 Jan 2024 13:22:04 GMT

Hi @mgranillo , I just tested this with the Qlik-cli and private sheets are preserved.
As the Qlik-cli is just a wrapper for the APIs, the API method is expected to work as well.

You can do some testing as well to confirm.

Re: Qlik Cloud: Unpublish an app with the REST API (PowerShell) or Qlik-Cli

mgranillo — Mon, 08 Jan 2024 20:24:35 GMT

@Daniele_Purrone the CLI method is working for me but I'm seeing something strange. After moving the app to the owner's personal space (step 2 above in method 2), I have non app owners that are able to see the app in their personal space. The duplicate is appearing as well in a non-owners personal space. The QMC does not show a copy in the non-owner's personal space yet I'm seeing the apps across two users.

To boil it down another way, a user is seeing an app that they don't own in their personal space. What is going on here?

Re: Qlik Cloud: Unpublish an app with the REST API (PowerShell) or Qlik-Cli

mgranillo — Mon, 08 Jan 2024 21:22:23 GMT

@Sonja_Bauernfeind In this workaround, the app is pulled down from production. Is that right? Our apps need to be up while we makes updates. A lot of our apps are utilized on a daily basis to answer business questions. Some updates may take weeks. We can't have our apps down for weeks. Can nothing else be done?

Is there any way to correct this so that we can overwrite the app again?

Re: Qlik Cloud: Unpublish an app with the REST API (PowerShell) or Qlik-Cli

Sonja_Bauernfeind — Tue, 09 Jan 2024 08:40:08 GMT

Hello @mgranillo

To be able to assist you better (and to give you a chance to get access to a larger audience), please summarize what you are aiming to do and what you want to achieve, as well as what challenge you've been facing and post this in the API forum (if you are looking to build a solution using our APIs) or the App Development forum (if you are facing general app development/process challenges).

All the best,
Sonja

Re: Qlik Cloud: How to Export apps from Managed spaces or unpublish an app with the REST API or Qlik-CLI

Gokryzex — Mon, 03 Mar 2025 21:48:39 GMT

Hi !

I'd like to pick up on the problem raised by @mgranillo
It's unthinkable to take an app out of production, even for a few minutes, whether for processing or to export the application with its data.

Has a solution been considered since the last message?

@mgranillo Have you managed to work around this issue?

Many thanks in advance.

Jordan

Re: Qlik Cloud: How to Export apps from Managed spaces or unpublish an app with the REST API or Qlik-CLI

mgranillo — Mon, 03 Mar 2025 22:09:40 GMT

@Gokryzex hard for me to remember everything but i think this is an old post. Qlik now has a way to re-establish the parent app because pulling down the app from production to duplicate it was crazy. This is from qlik help page:

The source app for a published app was deleted

If the source app for an app in a managed space is deleted, the published copy of the app cannot be updated and republished as needed.

You need to re-establish the parent-child relationship between a source app and the published app. You can do this by saving a backup copy of the published app, then re-publishing this backup copy from a personal or shared space.

Do the following:

Export the published copy of the app without data.

Exporting apps from managed spaces
Re-upload the app to a personal or shared space.
Publish the app back to the same managed space, with the same name as the existing published app.

When prompted, select Replace to replace the existing published copy of the app.