Skip to main content
Version: Latest (0.60.x)

Decorators

TypeSpec.OpenAPI

@defaultResponse

Specify that this model is to be treated as the OpenAPI default response. This differs from the compiler built-in @error decorator as this does not necessarily represent an error.

@TypeSpec.OpenAPI.defaultResponse

Target

Model

Parameters

None

Examples

@defaultResponse
model PetStoreResponse is object;

op listPets(): Pet[] | PetStoreResponse;

@extension

Attach some custom data to the OpenAPI element generated from this type.

@TypeSpec.OpenAPI.extension(key: valueof string, value: unknown)

Target

unknown

Parameters

NameTypeDescription
keyvalueof stringExtension key. Must start with x-
valueunknownExtension value.

Examples

@extension("x-custom", "My value")
@extension(
"x-pageable",
{
nextLink: "x-next-link",
}
)
op read(): string;

@externalDocs

Specify the OpenAPI externalDocs property for this type.

@TypeSpec.OpenAPI.externalDocs(url: valueof string, description?: valueof string)

Target

unknown

Parameters

NameTypeDescription
urlvalueof stringUrl to the docs
descriptionvalueof stringDescription of the docs

Examples

@externalDocs(
"https://example.com/detailed.md",
"Detailed information on how to use this operation"
)
op listPets(): Pet[];

@info

Specify OpenAPI additional information. The service title and version are already specified using @service.

@TypeSpec.OpenAPI.info(additionalInfo: TypeSpec.OpenAPI.AdditionalInfo)

Target

Namespace

Parameters

NameTypeDescription
additionalInfoAdditionalInfoAdditional information

@operationId

Specify the OpenAPI operationId property for this operation.

@TypeSpec.OpenAPI.operationId(operationId: valueof string)

Target

Operation

Parameters

NameTypeDescription
operationIdvalueof stringOperation id value.

Examples

@operationId("download")
op read(): string;