Skip to content

tsoa-next / @tsoa-next/runtime / Response

Function: Response() ​

ts
function Response<ExampleType, HeaderType>(
   name, 
   description?, 
   example?, 
   produces?): MethodDecorator & ClassDecorator;

Defined in: packages/runtime/src/decorators/response.ts:24

Adds a documented response that can be attached to a method or a controller.

Type Parameters ​

ExampleType ​

ExampleType

HeaderType ​

HeaderType extends | object | "Header names must be of type string" | "Header values must be string or string[]" = object

Parameters ​

name ​

| "400" | "401" | "402" | "403" | "404" | "405" | "406" | "407" | "408" | "409" | "410" | "411" | "412" | "413" | "414" | "415" | "416" | "417" | "418" | "422" | "423" | "424" | "425" | "426" | "428" | "429" | "431" | "451" | "500" | "501" | "502" | "503" | "504" | "505" | "506" | "507" | "508" | "510" | "511" | HttpStatusCodeLiteral | "100" | "200" | "301" | "302" | "303" | "307" | "308" | "101" | "102" | "201" | "202" | "203" | "204" | "205" | "206" | "207" | "208" | "226" | "300" | "304" | "305" | OtherValidOpenApiHttpStatusCode

The HTTP status code, OpenAPI response range, or default.

description? ​

string

The response description shown in the generated OpenAPI document.

example? ​

ExampleType

An example payload for the response schema.

produces? ​

string | string[]

The response media type or media types.

Returns ​

MethodDecorator & ClassDecorator

TypeScript-first OpenAPI generation, route generation, and runtime validation.