# Creating the catalog for platform connections #

You can create a Platform assets catalog to share connections across your organization\. Any user who you add as a collaborator to the catalog can see these connections\.

You can add an unlimited number of collaborators and connection assets to the Platform assets catalog\.

If you are signed up for both Cloud Pak for Data as a Service and watsonx, you share a single Platform assets catalog between the two platforms\. Any connection assets that you add to the catalog on either platform are available in both platforms\. However, if you add other types of assets to the Platform assets catalog on Cloud Pak for Data as a Service, you can't access those types of assets on watsonx\.

## Requirements ##

Before you create the Platform assets catalog, understand the required permissions and the requirements for storage and duplicate handling\.

**Required permission** : You must have the IAM Administrator role in the IBM Cloud account\. : To view your roles, go to **Administration > Access (IAM**)\. Then select **Roles** in the IBM Cloud console\.

**Storage requirement** : You must specify the IBM Cloud Object Storage instance configured during [IBM Cloud account setup](https://dataplatform.cloud.ibm.com/docs/content/wsj/admin/storage-options.html)\. If you are not an administrator for the IBM Cloud Object Storage instance, it must be [configured to allow catalog creation](https://dataplatform.cloud.ibm.com/docs/content/wsj/console/wdp_admin_cos.html)\.

**Duplicate asset handling** : Assets are considered duplicates if they have the same asset type and the same name\. : Select how to handle duplicate assets: : \- Update original assets : \- Overwrite original assets : \- Allow duplicates (default) : \- Preserve original assets and reject duplicates : You can change the duplicate handling preferences at any time on the catalog **Settings** page\.

## Creating the Platform assets catalog ##

To create the Platform assets catalog:

<!-- <ol> -->

1.  From the main menu, choose **Data > Platform connections**\.
2.  Click **Create catalog**\.
3.  Select the IBM Cloud Object Storage service\. If you don't have an existing service instance, [create a IBM Cloud Object Storage service instance](https://dataplatform.cloud.ibm.com/docs/content/wsj/console/wdp_admin_cos.html) and then refresh the page\.
4.  Click **Create**\. The Platform assets catalog is created in a dedicated storage bucket\. Initially, you are the only collaborator in the catalog\.
5.  Add collaborators to the catalog\. Go to the **Access control** page in the catalog and add collaborators\. You assign each user a [role](https://dataplatform.cloud.ibm.com/docs/content/wsj/catalog/platform-assets.html?context=cdpaas&locale=en#roles):
    
    <!-- <ul> -->
    
     *  Assign the **Admin** role at least one other user so that you are not the only person who can add collaborators.
     *  Assign the **Editor** role to all users who are responsible for adding connections to the catalog.
     *  Assign the **Viewer** role to the users who need to find connections and use them in projects.  
          
    <!-- </ul> -->
    
    You can give all the users access to the Platform assets catalog by assigning the **Viewer** role to the **Public Access** group. By default, all users in your account are members of the **Public Access** group. See [add collaborators](https://dataplatform.cloud.ibm.com/docs/content/wsj/catalog/catalog-collaborators.html).  
      
6.  Add connections to the catalog\. You can delegate this step to other collaborators who have the **Admin** or **Editor** role\. See [Add connections to the Platform assets catalog](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/platform-conn.html)\.

<!-- </ol> -->

### Platform assets catalog collaborator roles ###

The Platform assets catalog roles provide the permissions in the following table\.

<!-- <table> -->

| Action                      | Viewer | Editor | Admin |
| --------------------------- | ------ | ------ | ----- |
| View connections            | ✓      | ✓      | ✓     |
| Use connections in projects | ✓      | ✓      | ✓     |
| Use connections in spaces   | ✓      | ✓      | ✓     |
| View collaborators          | ✓      | ✓      | ✓     |
| Add connections             |        | ✓      | ✓     |
| Modify connections          |        | ✓      | ✓     |
| Delete connections          |        | ✓      | ✓     |
| Add or remove collaborators |        |        | ✓     |
| Change collaborator roles   |        |        | ✓     |
| Delete the catalog          |        |        | ✓     |

<!-- </table ""> -->

**Parent topic:**[Setting up the platform for administrators](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/setup-platform.html)

<!-- </article "role="article" "> -->