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.