Manage API collections

API definitions in 42Crunch Platform are organized into API collections. API collections group your APIs into meaningful units that are easier to manage than trying to keep track of individual APIs.

Create API collections

You can create new API collection either when importing an API, or separately for a future need.

  1. In 42Crunch Platform, click New collection under the main menu on the left.
  2. Enter a name for your collection.
  3. Click Add collection.

The API collection is created and added to the list of collections visible to you. You can now start importing APIs to your new collection.

An example screenshot of a newly created API collection. There are not yet any APIs n the collection and it is private, meaning that it was not shared with anyone when it was created.

View API collections

API collections are the first step to navigating the platform UI and finding your APIs.

  1. To view API collections you use often, click on the collection name in the list of recent API collections under the main menu on the left. You can see all the APIs in that collection.
  2. To view the full list of API collections visible to you, click API collections in the main menu.

    If you have plenty of collections, use the search bar at the top of the page to filter the collection list. You can use either the name or the UUID of the collection you want.

    An example screenshot of the API Collections page

    The collections you own are marked with . The collections that are shared with you are marked with or depending on the access level you have.

    Organization administrators have access to view and modify all API collections in their organization. This means that all API collections in an organization are visible to all organization administrators like the collections were their own, both on the API Collections page and in the monitoring dashboards. If an organization has several API collections, we recommend using more descriptive collection names that just organization and company name to be able to tell all collections apart.

  3. To view who owns a particular API collection in your organization (excluding the free Community organization), click > Show owner on the collection you want. You can see the name and the email address of the owner.

    An example screenshot showing the name and the email address of the owner of the API collection.

The collections you own are marked with , the collections that are shared with you are marked with .

If you have plenty of collections, use the search bar at the top of the page to filter the collection list. You can use either the name or the UUID of the collection you want.

Organization administrators have access to view and modify all API collections in their organization. This means that all API collections in an organization are visible to all organization administrators like the collections were their own, both on the API Collections page and in the monitoring dashboards. If an organization has several API collections, we recommend using more descriptive collection names that just organization and company name to be able to tell all collections apart.

Share API collections to other users

All API collections are private by default, meaning that they and the APIs in them are visible only to you. However, you can share API collections with other users in your organization, so they too can access your APIs. Sharing API collections instead of individual APIs makes it easier to keep track of what you have shared and who can see it.

You cannot share API collections if your account belongs to the free community organization, or your organization administrator has not given you permission for this function. For more details on permissions, see Permissions.

  1. Go to the API collection you want to share.
  2. Click Share API collection.
  3. Select the teams or users you want to share the collection with.
  4. Under Permissions, toggle the access level that each team or user will have to the collection.

    An example screenshot on editing the sharing of an API collection. The collection has been shared with one user and one team. The user has been granted Read/Write access to the collection, but the team only has Read-Only access to it.

  5. Click Update permissions.

Your API collection has now been shared with the teams or user you selected and they can now access it as you defined. To share the collection with more teams or users, change the access level, or make your collection private again, click Edit sharing.

An example screenshot that shows the sharing status of an API collection as well as who owns the collection. This collection is shared separately with one user and one team. There is also a button for editing the sharing next to the shring status.

For more details on the different access levels and what other users can or cannot do, see Sharing APIs and access level.

Export API collection details

Organization administrators and auditors can export the list of API collections in their organization, including details like the UUIDs and names of both the collection and its owner as well as the owner's email address. This allows, for example, organization administrators to communicate to collection owners when actions are required from them.

  1. In API collections, click .

    The screenshot shows the export icon above the list of API collections and the list of the options for export formats.

  2. Select the format (JSON or CSV) for the export.

The list of collections is exported as a file which you can, for example, use for further automation or open in a suitable program.

Change the owner of an API collection

Organization administrators can change the owner of any API collection in their organization to transfer full control of the collection to someone else.

  1. In API collections, go to the collection you want to transfer to someone else, and click > Change owner.
  2. Select the new owner for the API collection, and click Confirm.

The ownership of the API collection and all APIs in it is transferred to the user you selected.

Rename API collections

If you want to change the name you have given to your API collection, you can rename it.

  1. In API collections, go to the collection you want to rename, and click > Rename collection.
  2. Enter a new name for the collection, and click Rename.

Define a naming convention for API collections

Organization administrators can specify a regular expression that all API collections created in the organization must follow. The naming convention is applied in addition to the pattern already imposed by 42Crunch Platform.

If you have integrated API Security Audit to your CI/CD pipeline with the integration plugin, pay attention that you do not define a naming convention that conflicts with the one that the plugin uses, especially if you have changed the default collection name. This could prevent the integration plugin from working properly, which could disrupt your CI/CD.

  1. Click next to your username, and click Organization settings.
  2. Under Naming conventions, go to Collection.

    An example screenshot of configuring the collection naming convention.

  3. Define the regular expression for the pattern you want to use, and add an example of how the suitable name could look. If you want, you can also add a further description on the pattern.

    You can also provide a description for the naming convention on a web page outside 42Crunch Platform. In this case, simply include the URL where users can find more information in the description field; users can follow the link to learn more if the name they entered goes against the set convention.

  4. When ready, click Apply.

The naming convention is enforced all new API collections created in your organization, and if existing collections are renamed.

For more information on regular expressions, see the following:

Delete API collections

You can delete an API collection you want to remove from 42Crunch Platform. Deleting an API collection also removes the APIs in it from the platform.

Deleting an API collection permanently removes it from 42Crunch Platform. This action cannot be undone.

  1. Click API collections.
  2. On the collection you want to remove, click > Delete collection.