Skip to content
TypeSpec
Use cases
OpenAPI
Data Validation
Tooling support
Docs
Videos
Playground
Blog
Community
Version 1.17.0 is now available!
Search...
Menu
OpenAPI
Data Validation
Tooling support
Docs
Videos
Playground
Blog
Community
Getting started
Installation
Editor
VS Code Extension
Visual Studio Extension
Guides
TypeSpec for REST
Getting Started with TypeSpec For REST APIs
Operations and Responses
Handling Errors
Common Parameters
Authentication
Versioning
Custom Response Models
Conclusion
TypeSpec for OpenAPI Developers
Handbook
Cli usage
Style guide
Formatter
Package Manager
Reproducibility
Breaking Change Policy
Configuration
Configuration
Tracing
FAQ
📐 Language Basics
Overview
Built-in types
Identifiers
Imports
Namespaces
Decorators
Directives
Documentation
Scalars
Models
Operations
Interfaces
Templates
Enums
Functions
Unions
Intersections
Type Literals
Aliases
Values
Type Relations
Access Modifiers
Visibility
📘 Standard Library
Built-in Decorators
Built-in Data types
Js api
Classes
[C] UnserializableValueError
[C] UnsupportedScalarConstructorError
Enumerations
[E] IdentifierKind
[E] ListenerFlow
[E] ModifierFlags
[E] SemanticTokenKind
[E] UsageFlags
Functions
[F] $encodedName
[F] Numeric
[F] addService
[F] addVisibilityModifiers
[F] applyCodeFix
[F] applyCodeFixes
[F] assertType
[F] checkFormatTypeSpec
[F] clearVisibilityModifiersForClass
[F] compile
[F] compilerAssert
[F] createAddDecoratorCodeFix
[F] createDiagnosticCollector
[F] createRule
[F] createServer
[F] createSourceFile
[F] createSuppressCodeFix
[F] createSuppressCodeFixes
[F] createTypeSpecLibrary
[F] defineCodeFix
[F] defineLinter
[F] definePackageFlags
[F] defineTypeInfoProvider
[F] emitFile
[F] ensureTrailingDirectorySeparator
[F] explainStringTemplateNotSerializable
[F] filterModelProperties
[F] formatDiagnostic
[F] formatIdentifier
[F] formatTypeSpec
[F] getAllTags
[F] getAnyExtensionFromPath
[F] getAutoDecoratorTargets
[F] getAutoDecoratorValue
[F] getBaseFileName
[F] getDeprecated
[F] getDeprecationDetails
[F] getDirectoryPath
[F] getDiscriminatedTypes
[F] getDiscriminatedUnion
[F] getDiscriminatedUnionFromInheritance
[F] getDiscriminator
[F] getDoc
[F] getDocData
[F] getEffectiveModelType
[F] getEntityName
[F] getErrorsDoc
[F] getErrorsDocData
[F] getExamples
[F] getLifecycleVisibilityEnum
[F] getLocationContext
[F] getMaxItems
[F] getMaxItemsAsNumeric
[F] getMaxLength
[F] getMaxLengthAsNumeric
[F] getMaxValue
[F] getMaxValueAsNumeric
[F] getMaxValueExclusive
[F] getMaxValueExclusiveAsNumeric
[F] getMaxValueExclusiveForScalar
[F] getMaxValueForScalar
[F] getMediaTypeHint
[F] getMinItems
[F] getMinItemsAsNumeric
[F] getMinLength
[F] getMinLengthAsNumeric
[F] getMinValue
[F] getMinValueAsNumeric
[F] getMinValueExclusive
[F] getMinValueExclusiveAsNumeric
[F] getMinValueExclusiveForScalar
[F] getMinValueForScalar
[F] getNamespaceFullName
[F] getNormalizedAbsolutePath
[F] getNormalizedAbsolutePathWithoutRoot
[F] getNormalizedPathComponents
[F] getOpExamples
[F] getPagingOperation
[F] getParameterVisibilityFilter
[F] getPathComponents
[F] getPathFromPathComponents
[F] getPattern
[F] getPositionBeforeTrivia
[F] getProperty
[F] getPropertyType
[F] getRelativePathFromDirectory
[F] getReturnTypeVisibilityFilter
[F] getReturnsDoc
[F] getReturnsDocData
[F] getRootLength
[F] getSourceFileKindFromExt
[F] getSourceLocation
[F] getTags
[F] getTypeName
[F] getVisibilityForClass
[F] hasAutoDecorator
[F] hasTrailingDirectorySeparator
[F] hasVisibility
[F] ignoreDiagnostics
[F] interpolatePath
[F] isAnyDirectorySeparator
[F] isArrayModelType
[F] isDeclaredInNamespace
[F] isDeclaredType
[F] isDeprecated
[F] isErrorModel
[F] isErrorType
[F] isFileRef
[F] isGlobalNamespace
[F] isKey
[F] isNeverType
[F] isNullType
[F] isNumeric
[F] isNumericType
[F] isPathAbsolute
[F] isRecordModelType
[F] isSealed
[F] isService
[F] isStdNamespace
[F] isStringType
[F] isTemplateDeclaration
[F] isTemplateDeclarationOrInstance
[F] isTemplateInstance
[F] isType
[F] isTypeSpecValueTypeOf
[F] isUnknownType
[F] isUrl
[F] isValue
[F] isVisible
[F] isVoidType
[F] joinPaths
[F] listOperationsIn
[F] listServices
[F] logDiagnostics
[F] mapEventEmitterToNodeListener
[F] markDeprecated
[F] navigateProgram
[F] navigateType
[F] navigateTypesInNamespace
[F] normalizePath
[F] normalizeSlashes
[F] paramMessage
[F] reducePathComponents
[F] removeTrailingDirectorySeparator
[F] removeVisibilityModifiers
[F] reportDeprecated
[F] resetVisibilityModifiersForClass
[F] resolveCodeFix
[F] resolveCompilerOptions
[F] resolveEncodedEnumMemberValue
[F] resolveEncodedName
[F] resolveLinterDefinition
[F] resolveModule
[F] resolvePath
[F] resolveUsages
[F] sanitizePathSegment
[F] scopeNavigationToNamespace
[F] sealVisibilityModifiers
[F] sealVisibilityModifiersForProgram
[F] serializeValueAsJson
[F] setAutoDecorator
[F] setMediaTypeHint
[F] setTypeSpecNamespace
[F] typespecTypeToJson
[F] validateDecoratorNotOnType
[F] validateDecoratorUniqueOnNode
[F] walkPropertiesInherited
[P] JS API
Interfaces
[I] ArrayModelType
[I] ArrayValue
[I] BaseType
[I] BlockComment
[I] BooleanLiteral
[I] BooleanValue
[I] CallableMessage
[I] Checker
[I] CodeFix
[I] CodeFixContext
[I] CompileResult
[I] CompilerHost
[I] CompilerLocationContext
[I] CompilerOptions
[I] DecoratedType
[I] Decorator
[I] DecoratorApplication
[I] DecoratorArgument
[I] DecoratorContext
[I] DecoratorDefinition
[I] DecoratorFunction
[I] DecoratorImplementations
[I] DecoratorParamDefinition
[I] DecoratorValidator
[I] DecoratorValidatorCallbacks
[I] DeprecatedDirective
[I] DeprecationDetails
[I] Diagnostic
[I] DiagnosticCollector
[I] DiagnosticCreator
[I] DiagnosticDefinition
[I] DiagnosticMessages
[I] DirectiveBase
[I] DiscriminatedUnion
[I] DiscriminatedUnionLegacy
[I] Discriminator
[I] EmitContext
[I] EmitFileOptions
[I] EncodeData
[I] Enum
[I] EnumMember
[I] EnumValue
[I] ErrorType
[I] EventEmitter
[I] Example
[I] ExampleOptions
[I] FileLibraryMetadata
[I] FilePos
[I] FileRef
[I] FunctionContext
[I] FunctionParameterBase
[I] FunctionType
[I] FunctionValue
[I] IdentifierContext
[I] IndeterminateEntity
[I] InitProjectContext
[I] InsertTextCodeFixEdit
[I] Interface
[I] IntrinsicType
[I] LibraryInstance
[I] LibraryLocationContext
[I] LineAndCharacter
[I] LineComment
[I] LinterDefinition
[I] LinterResolvedDefinition
[I] LinterRuleContext
[I] LinterRuleSet
[I] ListOperationOptions
[I] LogInfo
[I] LogSink
[I] Logger
[I] MixedFunctionParameter
[I] MixedParameterConstraint
[I] Model
[I] ModelProperty
[I] ModuleLibraryMetadata
[I] Namespace
[I] NamespaceNavigationOptions
[I] NavigationOptions
[I] NeverType
[I] NullType
[I] NullValue
[I] Numeric
[I] NumericLiteral
[I] NumericValue
[I] ObjectValue
[I] ObjectValuePropertyDescriptor
[I] OpExample
[I] Operation
[I] PackageFlags
[I] PackageJson
[I] PagingOperation
[I] PagingProperty
[I] ParseOptions
[I] PatternData
[I] PositionDetail
[I] ProcessedLog
[I] Program
[I] ProjectLocationContext
[I] RecordModelType
[I] ReplaceTextCodeFixEdit
[I] ResolveCompilerOptionsOptions
[I] ResolveModuleHost
[I] ResolveModuleOptions
[I] RmOptions
[I] Scalar
[I] ScalarConstructor
[I] ScalarValue
[I] SemanticToken
[I] Server
[I] ServerCustomCapacities
[I] ServerHost
[I] ServerInitializeResult
[I] ServerLog
[I] ServerSourceFile
[I] ServerWorkspaceFolder
[I] Service
[I] ServiceDetails
[I] SignatureFunctionParameter
[I] SourceFile
[I] SourceLocation
[I] SourceLocationOptions
[I] SourceModel
[I] StateDef
[I] StringLiteral
[I] StringTemplate
[I] StringTemplateSpanLiteral
[I] StringTemplateSpanValue
[I] StringValue
[I] SuppressDirective
[I] SyntheticLocationContext
[I] TemplateInstanceTarget
[I] TemplateParameter
[I] TemplatedTypeBase
[I] TextRange
[I] Tracer
[I] TracerOptions
[I] Tuple
[I] TypeInfo
[I] TypeInfoContext
[I] TypeInstantiationMap
[I] TypeMapper
[I] TypeNameOptions
[I] TypeSpecLibrary
[I] TypeSpecLibraryDef
[I] TypeSpecManifest
[I] Union
[I] UnionVariant
[I] UnknownType
[I] UsageTracker
[I] VisibilityFilter
[I] VisibilityProvider
[I] VoidType
Type aliases
[T] BytesKnownEncoding
[T] CodeFixEdit
[T] Comment
[T] CreateTypeProps
[T] CustomRequestName
[T] DateTimeKnownEncoding
[T] Declaration
[T] DecoratorArgumentValue
[T] DiagnosticFormat
[T] DiagnosticHandler
[T] DiagnosticMap
[T] DiagnosticReport
[T] DiagnosticReportWithoutTarget
[T] DiagnosticResult
[T] DiagnosticSeverity
[T] DiagnosticTarget
[T] Directive
[T] DirectiveArgument
[T] DocContent
[T] DurationKnownEncoding
[T] EmitOptionsFor
[T] EmitterFunc
[T] Entity
[T] Expression
[T] FunctionParameter
[T] InferredTypeSpecValue
[T] InitProjectConfig
[T] InitProjectTemplate
[T] InitProjectTemplateEmitterTemplate
[T] InitProjectTemplateLibrarySpec
[T] IntrinsicScalarName
[T] JSONSchemaType
[T] LibraryMetadata
[T] LinterRule
[T] LinterRuleDefinition
[T] LinterRuleDiagnosticFormat
[T] LinterRuleDiagnosticReport
[T] LinterRuleDiagnosticReportWithoutTarget
[T] LinterRuleEnableValue
[T] LiteralType
[T] LocationContext
[T] LogLevel
[T] MarshalledValue
[T] MemberContainerType
[T] MemberType
[T] ModelIndexer
[T] Modifier
[T] ModuleResolutionResult
[T] NeverIndexer
[T] NewLine
[T] OperationContainer
[T] OperationSignature
[T] ReferenceExpression
[T] RuleRef
[T] RuleSetFileRef
[T] RuleSetRef
[T] SemanticNodeListener
[T] ServerLogLevel
[T] SourceFileKind
[T] Statement
[T] StdTypeName
[T] StdTypes
[T] StringTemplateSpan
[T] TemplatedType
[T] TrackableType
[T] Type
[T] TypeInfoProvider
[T] TypeKind
[T] TypeListeners
[T] TypeOfDiagnostics
[T] TypeSpecDiagnosticTarget
[T] TypeSpecValue
[T] Value
[T] WriteLine
Variables
[V] $defaultVisibility
[V] $discriminator
[V] $doc
[V] $encode
[V] $error
[V] $errorsDoc
[V] $example
[V] $format
[V] $friendlyName
[V] $inspectType
[V] $inspectTypeName
[V] $invisible
[V] $key
[V] $maxItems
[V] $maxLength
[V] $maxValue
[V] $maxValueExclusive
[V] $minItems
[V] $minLength
[V] $minValue
[V] $minValueExclusive
[V] $opExample
[V] $overload
[V] $parameterVisibility
[V] $pattern
[V] $removeVisibility
[V] $returnTypeVisibility
[V] $returnsDoc
[V] $secret
[V] $service
[V] $summary
[V] $tag
[V] $visibility
[V] $withDefaultKeyVisibility
[V] $withLifecycleUpdate
[V] $withOptionalProperties
[V] $withPickedProperties
[V] $withUpdateableProperties
[V] $withVisibility
[V] $withVisibilityFilter
[V] $withoutDefaultValues
[V] $withoutOmittedProperties
[V] EmptyVisibilityProvider
[V] MANIFEST
[V] NoTarget
[V] NodeHost
[V] VisibilityFilter
[V] discriminatedDecorator
[V] fileRef
[V] getEncode
[V] getFormat
[V] getFriendlyName
[V] getKeyName
[V] getOverloadedOperation
[V] getOverloads
[V] getPatternData
[V] getService
[V] getSummary
[V] isList
[V] isSecret
[API] Typekits
Encoded names
Discriminated Types
Examples
Pagination
📚 Libraries
Http
Overview
Rules
op-reference-container-route
Data types
Decorators
Js api
Enumerations
[E] Visibility
Functions
[F] $useAuth
[F] HttpVisibilityProvider
[F] addQueryParamsToUriTemplate
[F] createMetadataInfo
[F] getAllHttpServices
[F] getAuthentication
[F] getAuthenticationForOperation
[F] getContentTypes
[F] getCookieParamOptions
[F] getHeaderFieldName
[F] getHeaderFieldOptions
[F] getHttpFileModel
[F] getHttpOperation
[F] getHttpPart
[F] getHttpService
[F] getOperationParameters
[F] getOperationVerb
[F] getPatchOptions
[F] getPathParamName
[F] getPathParamOptions
[F] getQueryParamName
[F] getQueryParamOptions
[F] getResponsesForOperation
[F] getRouteOptionsForNamespace
[F] getRoutePath
[F] getServers
[F] getStatusCodeDescription
[F] getStatusCodes
[F] getStatusCodesWithDiagnostics
[F] getUriTemplatePathParam
[F] getVisibilitySuffix
[F] isApplicableMetadata
[F] isApplicableMetadataOrBody
[F] isBody
[F] isBodyIgnore
[F] isBodyRoot
[F] isCookieParam
[F] isHeader
[F] isHttpFile
[F] isMetadata
[F] isMultipartBodyProperty
[F] isOrExtendsHttpFile
[F] isOverloadSameEndpoint
[F] isPathParam
[F] isQueryParam
[F] isSharedRoute
[F] isStatusCode
[F] isVisible
[F] joinPathSegments
[F] listHttpOperationsIn
[F] reportIfNoRoutes
[F] resolveAuthentication
[F] resolveRequestVisibility
[F] setAuthentication
[F] setRoute
[F] setSharedRoute
[P] JS API
Interfaces
[I] AnyHttpAuthRef
[I] ApiKeyAuth
[I] Authentication
[I] AuthenticationOption
[I] AuthenticationOptionReference
[I] AuthenticationReference
[I] AuthorizationCodeFlow
[I] BasicAuth
[I] BearerAuth
[I] ClientCredentialsFlow
[I] CookieParameterOptions
[I] HeaderFieldOptions
[I] HttpAuthBase
[I] HttpBody
[I] HttpOperation
[I] HttpOperationBody
[I] HttpOperationBodyBase
[I] HttpOperationFileBody
[I] HttpOperationParameters
[I] HttpOperationResponse
[I] HttpOperationResponseContent
[I] HttpPart
[I] HttpPartOptions
[I] HttpServer
[I] HttpService
[I] HttpServiceAuthentication
[I] HttpStatusCodeRange
[I] ImplicitFlow
[I] MetadataInfo
[I] MetadataInfoOptions
[I] NoAuth
[I] NoHttpAuthRef
[I] OAuth2HttpAuthRef
[I] OAuth2Scope
[I] Oauth2Auth
[I] OpenIDConnectAuth
[I] PasswordFlow
[I] PathParameterOptions
[I] QueryParameterOptions
[I] RoutePath
Type aliases
[T] HttpAuth
[T] HttpAuthRef
[T] HttpOperationCookieParameter
[T] HttpOperationHeaderParameter
[T] HttpOperationMultipartBody
[T] HttpOperationMultipartPartBody
[T] HttpOperationParameter
[T] HttpOperationPart
[T] HttpOperationPathParameter
[T] HttpOperationQueryParameter
[T] HttpPayloadBody
[T] HttpProperty
[T] HttpStatusCodes
[T] HttpStatusCodesEntry
[T] HttpVerb
[T] OAuth2Flow
[T] OAuth2FlowType
[T] OperationContainer
[T] OperationVerbSelector
Variables
[V] $body
[V] $bodyIgnore
[V] $bodyRoot
[V] $cookie
[V] $delete
[V] $get
[V] $head
[V] $header
[V] $lib
[V] $linter
[V] $multipartBody
[V] $patch
[V] $path
[V] $post
[V] $put
[V] $query
[V] $route
[V] $server
[V] $sharedRoute
[V] $statusCode
Linter usage
Streams
Data types (streams)
[API] Typekits
Cheat sheet
Authentication
Operations
Files
Content types
Multipart requests
Encoding of types
Examples
OpenAPI
Overview
Data types
Decorators
Js api
Functions
[F] checkDuplicateTypeName
[F] getExtensions
[F] getExternalDocs
[F] getInfo
[F] getOpenAPITypeName
[F] getParameterKey
[F] isDefaultResponse
[F] isReadonlyProperty
[F] resolveInfo
[F] resolveOperationId
[F] setExtension
[F] setInfo
[F] shouldInline
[P] JS API
Interfaces
[I] AdditionalInfo
[I] Contact
[I] ExternalDocs
[I] License
[I] TagMetadata
[I] TagMetadataWithName
Type aliases
[T] DefaultResponseDecorator
[T] ExtensionDecorator
[T] ExtensionKey
[T] ExternalDocsDecorator
[T] InfoDecorator
Variables
[V] $defaultResponse
[V] $extension
[V] $externalDocs
[V] $info
[V] $operationId
[V] getOperationId
[V] getTagsMetadata
[V] setOperationId
Rest
preview
Overview
Data types
Decorators
Interfaces and Operations
Js api
Functions
[F] $copyResourceKeyParameters
[F] $createsOrReplacesResource
[F] $createsOrUpdatesResource
[F] $createsResource
[F] $deletesResource
[F] $resourceTypeForKeyParam
[F] $segment
[F] $updatesResource
[F] getAction
[F] getActionDetails
[F] getActionSegment
[F] getActionSeparator
[F] getCollectionAction
[F] getCollectionActionDetails
[F] getResourceLocationType
[F] getResourceOperation
[F] getResourceTypeForKeyParam
[F] getResourceTypeKey
[F] getSegment
[F] isAutoRoute
[F] isListOperation
[F] setResourceOperation
[F] setResourceTypeKey
[P] JS API
Interfaces
[I] ActionDetails
[I] AutoRouteOptions
[I] FilteredRouteParam
[I] ResourceKey
[I] ResourceOperation
Type aliases
[T] ResourceOperations
Variables
[V] $action
[V] $actionSegment
[V] $actionSeparator
[V] $autoRoute
[V] $collectionAction
[V] $lib
[V] $listsResource
[V] $parentResource
[V] $readsResource
[V] $resource
[V] $resourceLocation
[V] $segmentOf
[V] getParentResource
[V] setParentResource
Cheat sheet
Resource and routes
Events
preview
Overview
Decorators
Js api
Functions
[F] $onValidate
[P] JS API
Variables
[V] $decorators
[V] $lib
[V] getContentType
[V] isEventData
[V] isEvents
SSE
preview
Overview
Data types
Decorators
Js api
Functions
[F] $onValidate
[P] JS API
Variables
[V] $decorators
[V] $lib
[V] isTerminalEvent
Streams
preview
Overview
Data types
Decorators
Js api
Functions
[F] isStream
[P] JS API
Variables
[V] $decorators
[V] $lib
[V] getStreamOf
Versioning
preview
Overview
Decorators
Js api
Classes
[C] VersionMap
Enumerations
[E] Availability
Functions
[F] $onValidate
[F] $removed
[F] $useDependency
[F] createVersionMutator
[F] findVersionedNamespace
[F] getAddedOnVersions
[F] getAllVersions
[F] getAvailabilityMap
[F] getAvailabilityMapInTimeline
[F] getCachedNamespaceDependencies
[F] getMadeOptionalOn
[F] getRemovedOnVersions
[F] getRenamedFrom
[F] getRenamedFromVersions
[F] getReturnTypeChangedFrom
[F] getTypeChangedFrom
[F] getUseDependencies
[F] getVersion
[F] getVersionDependencies
[F] getVersionForEnumMember
[F] getVersioningMutators
[F] getVersions
[F] getVersionsForEnum
[F] resolveVersions
[P] JS API
Interfaces
[I] TransientVersioningMutator
[I] Version
[I] VersionResolution
[I] VersionSnapshotMutation
[I] VersionedMutators
Variables
[V] $added
[V] $madeOptional
[V] $madeRequired
[V] $renamedFrom
[V] $returnTypeChangedFrom
[V] $typeChangedFrom
[V] $versioned
Tutorial
Xml
preview
Overview
Decorators
Js api
Functions
[F] getNs
[F] getXmlEncoding
[F] isAttribute
[F] isUnwrapped
[P] JS API
Interfaces
[I] XmlEncodeData
[I] XmlNamespace
Type aliases
[T] AttributeDecorator
[T] NameDecorator
[T] NsDeclarationsDecorator
[T] NsDecorator
[T] UnwrappedDecorator
[T] XmlEncoding
Variables
[V] $attribute
[V] $lib
[V] $name
[V] $ns
[V] $nsDeclarations
[V] $unwrapped
Guide
🖨️ Emitters
JSON Schema
Overview
Data types
Decorators
Emitter usage
Js api
Functions
[F] $onEmit
[F] findBaseUri
[F] getExtensions
[F] getJsonSchemaTypes
[F] getMultipleOf
[F] isJsonSchemaDeclaration
[F] setExtension
[P] JS API
Interfaces
[I] ExtensionRecord
[I] JSONSchemaEmitterOptions
Type aliases
[T] BaseUriDecorator
[T] ContainsDecorator
[T] ContentEncodingDecorator
[T] ContentMediaTypeDecorator
[T] ContentSchemaDecorator
[T] ExtensionDecorator
[T] IdDecorator
[T] JsonSchemaDeclaration
[T] JsonSchemaDecorator
[T] MaxContainsDecorator
[T] MaxPropertiesDecorator
[T] MinContainsDecorator
[T] MinPropertiesDecorator
[T] MultipleOfDecorator
[T] OneOfDecorator
[T] PrefixItemsDecorator
[T] UniqueItemsDecorator
Variables
[V] $baseUri
[V] $contains
[V] $contentEncoding
[V] $contentMediaType
[V] $contentSchema
[V] $extension
[V] $flags
[V] $id
[V] $jsonSchema
[V] $lib
[V] $maxContains
[V] $maxProperties
[V] $minContains
[V] $minProperties
[V] $multipleOf
[V] $oneOf
[V] $prefixItems
[V] $uniqueItems
[V] EmitterOptionsSchema
[V] getBaseUri
[V] getContains
[V] getContentEncoding
[V] getContentMediaType
[V] getContentSchema
[V] getId
[V] getJsonSchema
[V] getMaxContains
[V] getMaxProperties
[V] getMinContains
[V] getMinProperties
[V] getMultipleOfAsNumeric
[V] getPrefixItems
[V] getUniqueItems
[V] isOneOf
OpenAPI3
Overview
Data types
Decorators
Diagnostics
duplicate-header
inline-cycle
invalid-schema
invalid-server-variable
path-query
union-null
Emitter usage
Js api
Functions
[F] $onEmit
[F] convertOpenAPI3Document
[F] getOneOf
[F] getOpenAPI3
[F] getRef
[F] resolveOptions
[P] JS API
Interfaces
[I] OpenAPI3ApiKeySecurityScheme
[I] OpenAPI3AuthorizationCodeOAuthFlow
[I] OpenAPI3ClientCredentialsFlow
[I] OpenAPI3Components
[I] OpenAPI3Discriminator
[I] OpenAPI3Document
[I] OpenAPI3Example
[I] OpenAPI3ExternalDocs
[I] OpenAPI3HttpSecurityScheme
[I] OpenAPI3ImplicitOAuthFlow
[I] OpenAPI3Info
[I] OpenAPI3OAuth2Flow
[I] OpenAPI3OAuth2SecurityScheme
[I] OpenAPI3OAuthFlows
[I] OpenAPI3OpenIdConnectSecurityScheme
[I] OpenAPI3PasswordOAuthFlow
[I] OpenAPI3SecuritySchemeBase
[I] OpenAPI3Server
[I] OpenAPI3ServerVariable
[I] OpenAPI3Tag
[I] OpenAPI3UnversionedServiceRecord
[I] OpenAPI3VersionedDocumentRecord
[I] OpenAPI3VersionedServiceRecord
[I] OpenAPIApiKeySecurityScheme3_2
[I] OpenAPIComponents3_1
[I] OpenAPIComponents3_2
[I] OpenAPIDeviceAuthorizationFlow3_2
[I] OpenAPIDocument3_1
[I] OpenAPIDocument3_2
[I] OpenAPIEncoding3_2
[I] OpenAPIExample3_2
[I] OpenAPIHttpSecurityScheme3_2
[I] OpenAPIMediaType3_2
[I] OpenAPIOAuth2SecurityScheme3_2
[I] OpenAPIOAuthFlows3_2
[I] OpenAPIOpenIdConnectSecurityScheme3_2
[I] OpenAPIRequestBody3_2
[I] OpenAPIResponse3_2
[I] OpenAPISecuritySchemeBase3_2
[I] OpenAPIServer3_2
[I] OpenAPITag3_2
[I] OpenAPIXmlSchema3_2
[I] Ref
[I] ResolvedOpenAPI3EmitterOptions
Type aliases
[T] CommonOpenAPI3Schema
[T] Extensions
[T] HttpMethod
[T] JsonSchema
[T] JsonSchemaType
[T] JsonType
[T] OpenAPI3Encoding
[T] OpenAPI3Header
[T] OpenAPI3HeaderParameter
[T] OpenAPI3Link
[T] OpenAPI3MediaType
[T] OpenAPI3Operation
[T] OpenAPI3Parameter
[T] OpenAPI3ParameterBase
[T] OpenAPI3ParameterType
[T] OpenAPI3PathItem
[T] OpenAPI3PathParameter
[T] OpenAPI3QueryParameter
[T] OpenAPI3RequestBody
[T] OpenAPI3Response
[T] OpenAPI3Responses
[T] OpenAPI3Schema
[T] OpenAPI3SecurityScheme
[T] OpenAPI3ServiceRecord
[T] OpenAPI3StatusCode
[T] OpenAPI3XmlSchema
[T] OpenAPICookieParameter3_2
[T] OpenAPIHeaderParameter3_2
[T] OpenAPIHttpMethod3_2
[T] OpenAPIOperation3_2
[T] OpenAPIParameter3_2
[T] OpenAPIParameterBase3_2
[T] OpenAPIParameterType3_2
[T] OpenAPIPathItem3_2
[T] OpenAPIPathParameter3_2
[T] OpenAPIQueryParameter3_2
[T] OpenAPIQueryStringParameter3_2
[T] OpenAPIResponses3_2
[T] OpenAPISchema3_1
[T] OpenAPISchema3_2
[T] OpenAPISecurityScheme3_2
[T] Refable
[T] SupportedOpenAPIDocuments
[T] SupportedOpenAPISchema
Variables
[V] $lib
[V] $oneOf
[V] $useRef
[V] namespace
OpenAPI v3 emitter
OpenAPI3 to TypeSpec
Protobuf
preview
Overview
Data types
Decorators
Emitter usage
Js api
Functions
[F] $onEmit
[F] $onValidate
[F] $service
[F] isMap
[P] JS API
Interfaces
[I] LongRunningInfo
[I] PackageDetails
Type aliases
[T] Reservation
Variables
[V] $externRef
[V] $field
[V] $lib
[V] $message
[V] $package
[V] $reserve
[V] $stream
[V] PROTO_FULL_IDENT
[V] PROTO_IDENT
[V] namespace
Guide
GraphQL
preview
Overview
Data types
Decorators
Emitter usage
Js api
Functions
[F] $onEmit
[F] createGraphQLMutationEngine
[P] JS API
Variables
[V] $decorators
[V] $lib
Guide
Clients
Client Emitters
Javascript
preview
Overview
Emitter usage
Java
preview
Overview
Emitter usage
Python
preview
Overview
Emitter usage
Package Structure
CSharp
preview
Overview
Decorators
Emitter usage
Servers
ASP.Net
alpha
Overview
Emitter usage
About Generated Projects
JavaScript
alpha
Overview
Emitter usage
About Generated Projects
🛠️ Writing TypeSpec Libraries
Creating a TypeSpec Library
Diagnostics
Decorators
Providing type info to IDEs & tooling
experimental
Linters
Code fixes
Testing
Emitters
Functions
Emitter framework
Performance Reporting
Managing metadata and visibility in REST API emitters
Scaffolding templates
🚀 Release Notes
GitHub
Discord
Select theme
Dark
Light
Auto
[T] StdTypeName
type
StdTypeName
=
keyof
StdTypes
;
Names accepted when looking up a standard-library type.