In OpenAPI terms, paths are endpoints (resources), such as /users or /reports/summary, that your API exposes, and operations are the HTTP methods used to manipulate these paths, such as GET, POST or DELETE.

Tags ​

To attach a controller or an endpoint to a specific tag, use the @Tag(tagName) decorator.

@Tag('cats')
@Controller('todo')
export class TodoController {
  @Tag('get')
  @Get(':id')
  async getById(@Param('id') id: string): Todo {
    return this.todoService.getById(id);
  }
}

Description ​

Simply use @Description decorator to describe your endpoint. We love description.

@Controller('todo')
export class TodoController {
  @Description('Get a Todo by ID')
  @Get(':id')
  async getById(@Param('id') id: string): Todo {
    return this.todoService.getById(id);
  }
}