Adding elements to your assembly

Create your API assembly by using the Assemble view in the API Designer. You can access the Assemble view by clicking the Gateway tab in the API editor.

To add elements to your assembly using the assembly tool, complete the following steps:

1. In the navigation pane, click Develop, then select the APIs tab.
   The Develop page opens.
2. Click the title of the API definition that you want to work with.
3. Use the Policies view to add an element.
   Note: You must specify a version for the policy. To prevent errors due to incompatible versions of a policy between the API and the gateway, API Connect will only publish an API to the gateway if the policy version in the API exactly matches the version that is present on the gateway.
   1. Select the Gateway tab, then click Policies in the navigation pane.
   2. Click the plus icon at the appropriate location on the canvas to view the palette that lists the available elements.
   3. Select the element that you want to add from the palette to the canvas by clicking it.
      Note:

      • Elements are applied in order from the initial, unfilled, circle to the final, filled, circle.
      • Unless an Operation Switch element is used, the whole assembly applies to every operation in the API.
   4. Add and edit properties of the element by clicking the element and using the property sheet.
      For some elements, you can add and remove properties by clicking Object Properties and selecting the property from the drop-down list. For information about the properties of policy elements, see API policies and logic constructs. For information about the properties of logic constructs, see Logic Constructs.
   5. Specify a version for the policy.
      To add a version, click the Source icon , and complete the version section of the policy YAML. For example:

      execute:
        - invoke:
            version: 2.2.0
            title: invoke
      ...

      You must specify a version for the policy that is compatible with the gateway that you are using. When the API is published, if the version is incompatible with the gateway, a validation error is thrown that specifies the available versions. For more information about how to configure the policy OpenAPI YAML, see execute OpenAPI extension.
4. Optional: Repeat Steps 3.b to 3.e for any additional elements that you want to add.
5. Click Save to save your changes.