Deleting an App Pin with the API
If you have pinned an app, you can delete the pin at any time. Pinned apps can be restored. If you delete the pin, that version of the app cannot be restored. Deleting the pin does not affect the current app.
Note: Only Flogo and TIBCO BusinessWorks apps can be pinned.
Considerations
- When you delete a pin, the PIN DELETED action is recorded and displays in the App Details History tab for the selected app.
To delete a pin from an app, you need the following:
- Subscription Locator — The Subscription Locator of the Organization you want to access. To find Subscription Locators for your organizations use the
GET /v1/userinfomethod to return a list of all of the organizations for your OAuth Token with their Subscription Locators. You can use 0 as the Subscription Locator for the organization that owns the OAuth token. - App ID — ID of the app to be accessed, which can be retrieved using the
GET /v1/subscriptions/{subscriptionLocator}/appsmethod.
- Use the
DELETE /v1/subscriptions/{subscriptionLocator}/apps/{appId}/pinmethod to delete the pin for the selected app. - Use the
GET /v1/subscriptions/{subscriptionLocator}/apps/{appId}/pinmethod to verify that the pin has been deleted for the selected app.
Role Requirements
Only Admin users can unpin an app.