This pageapplies toApigee andApigee hybrid.

This page describes how to set up custom curations in API hub. Custom curations enable you to override the default curation logic of yourplugin instances to implement a tailored data transformation and enrichment process based on your organization's needs.

Before you begin

Ensure the following before setting up a custom curation:

• Provision Application Integration in your Google Cloud project. SeeSet up Application Integration for more information.Note: You must provision Application Integration in the same Google Cloud project and region as your API hub instance.

Create a custom curation

To create a new custom curation logic, do the following:

1. Create an integration for the custom curation in Application Integration.
2. Set up a custom curation in API hub.

Create an integration for the custom curation in Application Integration

To create a custom curation logic in Application Integration, perform the following steps:

1. In the Google Cloud console, go to theApplication Integration page.

   Go to Application Integration

2. In the navigation menu, clickIntegrations. TheIntegrations page appears.
3. Clickadd_boxCreate integration and provide the following details in theCreate Integration page:
   1. Integration name: Enter a name for your integration.
   2. Description: Optionally, enter a description for your integration.
   3. Region: Select the region for your integration. This must be the same region as your API hub instance.
   4. ClickCreate to open the integration in the integration editor.
4. Configureintegration variables using theApiData definition. These variables will be used as input and output task variables for the custom curation logic.
5. Add anAPI trigger and use the availabletasks to build your custom curation logic.
6. Once complete, clickPublish to publish the integration.

For more information about Application Integration, see theApplication Integration documentation.

Set up a custom curation

Once you have created and published your integration in Application Integration, you can set up the custom curation in API hub. To set up a custom curation, do the following:

1. In the Google Cloud console, go to theAPI hub page.

   Go to API hub

2. ClicksettingsSettings from the left navigation menu to open theSettings page.
3. Click theCurations tab to view the list of curations.
4. ClickSetup a new curation.
5. In theSet up curation pane, provide the following details:
   1. Optional: ClickSpecify ID to provide a unique ID for the curation. API hub generates a unique ID if you don't provide one.Note: The ID must be between 4 to 500 characters in length and can only contain the following characters:/[A-Z][a-z][0-9]-/.
   2. Display name: Enter a name for the curation.
   3. Description: Enter a description for the curation.
   4. If you have an existing integration created for your curation logic in Application Integration, do the following underAssociate an existing integration section:
      1. Integration: Choose the integration that you want to associate for the curation.Note: Only published integrations can be associated for curations.
      2. Trigger ID: Choose the API trigger ID that you want to associate for the curation.
   5. If you don't have an existing integration created for your curation logic in Application Integration, follow the instructions inCreate an integration for the custom curation to create an integration and then continue fromStep 5d.
6. ClickCreate curation to initiate the creation of the custom curation.

   On successful creation, the curation is listed underManage curations as shown in the following image:

   

What's next

• Learn how toview and manage curations.
• Learn how toedit the configuration of a plugin instance.