x-tagGroups

Usage

Use x-tagGroups to group tags in the Reference docs navigation sidebar. Add it to the root OpenAPI object.

Important

When using x-tagGroups, a tag that is not in a group will not be displayed at all. You must add every tag to at least one group.

Field Name	Type	Description
x-tagGroups	[ Tag Group Object ]	A list of tag groups.

Tag group object

Field Name	Type	Description
name	string	The group name.
tags	[ string ]	List of tags to include in this group.

Examples

YAMLJSON

Copy

Copied

openapi: '3.0'
info: ...
tags:
  - name: Customers
  - name: Customer Authentication
  - name: AML
  - name: Customers Timeline
  - name: Payment Instruments
  - name: Payment Tokens
  - name: Payment Cards
x-tagGroups:
  - name: Customers
    tags:
      - Customers
      - Customer Authentication
      - AML
      - Customers Timeline
  - name: Payment Instruments
    tags:
      - Payment Instruments
      - Payment Tokens
      - Payment Cards

Copy

Copied

{
  "x-tagGroups": [
    {
      "name": "Customers",
      "tags": ["Customers", "Customer Authentication", "AML", "Customers Timeline"]
    },
    {
      "name": "Payment Instruments",
      "tags": ["Payment Instruments", "Payment Tokens", "Payment Cards"]
    }
  ]
}

In Reference docs

Rebilly API Reference documentation

Related options

Use x-displayName and x-traitTag to further customize tags.