Skip to main content

Subscriptions (Studios)

Important

In a coming release, to streamline your asset management, subscriptions (studios) are going away. Assets will be associated with users rather than a given subscription (studio). If you have assets in your private studio these will be associated with your user instead.

If you are using subscriptions (studios) to share assets, we recommend that you migrate shared assets to Collections to prepare for this improvement. Go to Migrate Subscriptions to Collections for more info.

Note

If you prefer using Collections as a way of associating assets with users rather than a given subscription (studio), you have the option to migrate shared assets to collections. Go to Migrate Subscriptions to Collections for more info.

A subscription allows Designer users to publish and share workflows privately within your organization. Server admins can create subscriptions and manage the users and workflows assigned to them. Subscriptions are also known as studios.

A private studio (in other words, subscription) is automatically created for each Server user. When a user creates a workflow in Designer and publishes it to the Server, the workflow is added to the user's private studio (subscription). Workflows published to the private studio are private. Only other users assigned to the private studio (subscription) can see the workflows.

To manage subscriptions, go to the Subscriptions page of the Server Admin interface.

Create a New Subscription

  1. On the Subscriptions page, select Add New Subscription.

  2. Select Yes or No for API Enabled. Access to the private Server API is disabled by default. The Server API supports the ability to authenticate, list apps, run apps, and retrieve app results using an API Key and Secret from Server Settings. Go to the Server API Overview for more info.

  3. Select Yes or No for Shared Schedules Enabled. Yes allows users to view and edit the schedules and job results for workflows published by all users in the subscription.

  4. (Optional) To add Default Workflow Credentials select Set Account. Go to Credentials for more info.

    1. Select a saved credential in the Workflow Credentials dropdown.

    2. Select OK.

  5. Select Save.

The new subscription is added to the Subscriptions page.

Add a User to a Subscription

  1. On the Subscriptions page, select a subscription.

  2. Select Add User. Enter the username and select the user when it appears. Note, this changes the user's private studio (subscription) and removes their access to the workflows in their existing subscription.

Remove a User from a Subscription

Users can only have one subscription. So, you have to add a user to a new subscription to remove them from their existing subscription. There are 2 methods for moving a user from one subscription to another.

  • Copy the Subscription Id of the new subscription and paste it in the Subscription Id field in the user's profile.

OR

  • Go to the new subscription you want to add the user to. Select Add User. Enter the username and select the user when it appears. Note, this changes the user's private studio (subscription) and removes their access to the workflows in their existing subscription.

Edit a Subscription

  1. On the Subscriptions page, select a subscription.

  2. Enter a new Private Studio Name.

  3. Select a new worker in the Assigned Worker dropdown.

  4. Select Yes or No for API Enabled. Access to the private Server API is disabled by default. The Server API supports the ability to authenticate, list apps, run apps, and retrieve app results using an API Key and Secret from Server Settings. Go to the Server API Overview for more info.

  5. Select Yes or No for Shared Schedules Enabled. Yes allows users to view and edit the schedules and job results for workflows published by all users in the subscription.

  6. To change Default Workflow Credentials select Change Account. Go to Credentials for more info.

    1. Select a saved credential in the Workflow Credentials dropdown.

    2. Select OK.

  7. To add a user to the subscription, select Add User. Enter the username and select the user when it appears. Note, this changes the user's private studio (subscription) and removes their access to the workflows in their existing subscription.

  8. Select Save.

Delete a Subscription

Before you delete a subscription (studio), you have to remove all users from it. To do so, add the users to another subscription.

To delete a subscription, find the subscription and select the trash icon next to the subscription name. Note, deleting a subscription also deletes the workflows in that subscription.

Default Worker Tag Change

After the upgrade from a lower version of Server to 21.4, the Default Worker Tag at the Subscription level changed to "Unassigned". The intended change was to remove the Default Worker Tag at the Subscription level and move it to both the User and Admin levels. Currently, the Default Worker Tag has only been added to the User level but not yet to the Admin level. You can also still see this functionality at the Subscription level but it is no longer functional.

Therefore, as an admin, you cannot currently set the Default Worker Tag via Server Administration. As a workaround, you can set it via the V3 API, if needed. In the meantime, we are prioritizing work to add it to the Admin side for user profiles. To set the Default Worker Tag via the V3 API, use the PUT {baseURL}/v3/users/{id} endpoint. For more information about this endpoint, go to the User Endpoints help page.

In this section: