Adding tags to an operation

You can include tags in API operation definition. Such tags are added to the OpenAPI definition of the API but are not used by API Connect for any indexing.

About this task

Note: This task relates to configuring an OpenAPI 2.0 API definition. For details on how to configure an OpenAPI 3.0 API definition, see Editing an OpenAPI 3.0 API definition.

You can complete this task either by using the API Designer UI application, or by using the browser-based API Manager UI.

At any time, you can switch directly to the underlying OpenAPI YAML source by clicking the Source icon OpenAPI Source icon. To return to the design form, click the Form icon Form icon.


  1. Open the API for editing, as described in Editing an OpenAPI 2.0 API definition.
  2. Expand Paths, then expand the required Path.
  3. Expand Operations, then expand the required operation.
  4. To add a new operation tag, click the add icon OpenAPI 2.0 API add icon alongside the Tags entry for the operation in the navigation pane. To edit an existing tag, expand Tags then click the tag name in the navigation pane.
  5. Provide the following information:
    • Name (required): The name of the tag.
  6. If you are creating a new operation tag, click Create.
  7. Click Save when done.