Repository navigation
Releases
v1.38.0
v1.37.0
Added
- Ruby: a deprecated operation, path, model, enum, property or parameter carries a YARD
@deprecatedtag with the description's deprecation text, date, removal date and version. Calling a deprecated method or navigating to a deprecated path also warns withcategory: :deprecated, which Ruby prints whenWarning[:deprecated]is on, as it does for its own deprecations. kiota-ruby#64 - Ruby: models generated with
--backing-storekeep their values in the runtime's backing store and send only the values changed since they were read, as the other languages do. Before,--backing-storegenerated Ruby that failed to load. Requires the runtime gems at 0.25.0. kiota-ruby#53 - Ruby: generated clients register the text, form and multipart serializers, so
text/plain,application/x-www-form-urlencodedandmultipart/form-databodies work, as in the other languages. Requires the runtime gems at 0.25.0. kiota-ruby#52, kiota-ruby#55, kiota-ruby#57
Changed
- The accessor to a child path is marked deprecated when that path is deprecated. It used to take the deprecation of its parent path instead, so a deprecated
/legacyunder a live/apiwas not flagged, and every child of a deprecated path was. - TypeScript: guard union discriminator access and preserve dispatch for identifiable values even when some members lack the property; fall back to serializing all members for unidentified values without referencing nonexistent properties.
- TypeScript: resolve factory default deserializers in the declared model's namespace, preventing unresolved references to similarly named deserializers in child namespaces. Fixes #8461.
- Ruby:
kiota infolists the runtime gems at 0.25.0.
v1.36.1
Added
Changed
- Fixed small issues with release pipelines
v1.36.0
Added
- Ruby: an error's
messagereturns the property the description marks withx-ms-primary-error-message, as the other languages do. An error property namedmessageis renamedmessage_escaped, likeMessageEscapedin C#; when it is a string,messagestill returns it. kiota-ruby#63
Changed
-
Fixed relative description paths when opening or selecting clients in the VS Code Kiota workspace.
-
Removed the retired lock-search command from the VS Code command palette. Lock-file migration remains available.
-
Preserve inherited properties when a single
oneOforanyOfmember defines its properties only throughallOf. Fixes #6778. -
Python: preserve false, zero, empty strings, and empty collections when parsing and serializing union type wrappers.
-
All language refiners accept a generation logger consistently, retaining configuration-only compatibility constructors hidden from IntelliSense.
-
Reject plugin-manifest file references whose path components become parent-directory traversal after Windows trims trailing spaces or dots.
-
Fixed a stack overflow when generating API plugins from descriptions with cyclic
allOfschemas. -
Dart: omit unsupported schema defaults with a generation warning, preserve supported literal and enum property and parameter defaults (including empty strings), initialize query parameters from schema defaults, and keep constructor initialization valid with or without backing stores.
-
Dart: preserve nullable optional request-builder constructor parameters, including UUIDs and collections, so cloning accepts null arguments without overwriting existing path parameters.
-
Dart: escape URL templates once at final emission to preserve literal dollar signs and backslashes in constructor defaults and method overrides.
-
Dart: preserve schema string defaults named
null, including enum wire values, without treating them as JSON-null sentinels. -
Dart: preserve query-parameter defaults inside single-member
allOfwrappers, retaining outer-default precedence and explicit JSON-null defaults. -
Dart: validate parser-backed date, time, and UUID defaults before emission, omitting unsupported values with a generation warning.
-
Ruby: a union of object types that no discriminator decides, such as a oneOf without a discriminator, now reads the payload into every object member, as TypeScript does, instead of returning an empty wrapper. A union whose discriminator matched no member does the same, and its array member is only read when no other member was picked. Requires the runtime gems at 0.24.0.
-
Ruby: enum members hold their wire value, so a value such as
incoming-paymentorreadis sent and read as the description declares it instead of asIncomingPaymentorRead.Enum[:Name]now returns the wire value as a string. Requires the runtime gems at 0.24.0. -
Go: keep escaped namespace segments lowercase so imports match generated package directories on case-sensitive filesystems. Fixes #7828.
-
TypeScript: import response enum objects for request builders reached through path parameters. #6884
-
Resolve enum query parameters wrapped in single-member
allOfschemas, including enum array items. -
Go: cast scalar enum values in union factories and avoid reading an empty discriminator name for undiscriminated unions. Addresses #7808.
-
Preserve models for multipart properties with default content types when other properties specify an encoding. #7342
-
Dart: escape enum options named value or values to avoid conflicts with generated and built-in enum members. #7807
-
Ruby: the client's root module has an
eager_load!method that loads every autoloaded model, for servers that preload before forking. -
Ruby: generated files start with
# frozen_string_literal: true, so string default values handed to user code are frozen. -
Ruby: generated string literals are double quoted, the StandardRB convention.
-
Ruby: namespaces with nothing to autoload no longer get an empty barrel file, and generated files no longer require them (561 fewer files in a GitHub client).
-
Ruby: a client generated with a multi-segment
--namespace-name, such asintegration_test.client, failed to load because its root file was written one directory too deep. -
Ruby: namespace barrels register their models and enums with
autoloadinstead of requiring them, so a subclass no longer fails to load when its base class file is required first. Other files require the barrel rather than an individual model file, and models now load on first use. A type no barrel autoloads, such as a model named after its namespace, is now required directly: 1,315 constants referenced by a Meraki client never loaded, and a client generated from the current GitHub description failed to load because it required a file that is never written. #7956 -
Ruby: model properties are declared with
attr_accessor, which removes the thousands of "possibly useless use of a variable" warningsruby -wprinted while loading a client. -
Ruby: enum hashes are frozen. kiota-ruby#68
-
C#: escape Unicode line and paragraph separators in generated string literals so generated clients remain valid C# source.
-
External reference allowlist wildcards no longer cross the URI authority boundary, so a wildcard in the scheme or host cannot match text in the path, the user information or the port.
-
Initialize inherited Dart model fields in constructor initializer lists.
-
Replace only unresolved binary types with a native stream type, and translate a resolved model by its definition rather than its name, so a model whose schema is named
binary,base64orbase64urlkeeps its own name across every language instead of being rendered as the native binary type. Generation no longer fails for C# and Java. -
Avoid redundant parsing branches for equivalent binary alternatives in Dart and PHP composed models.
-
Preserve imports for distinct types from the same namespace when inlining error model inheritance.
-
Dart: qualify model fields named
nodeordeserializerMapduring deserialization so local variables do not shadow them; escapeoverridemodel members to preserve Dart annotations. Fixes #7822. -
PHP: disambiguate enum constants that normalize to the same name while preserving wire values and existing constant names.
-
Java: omit unused discriminator-mapping imports for union/intersection wrappers, avoiding imports of nonexistent models while retaining member and inherited-factory imports.
-
Dart: omit unused discriminator-mapping imports for composed wrappers while preserving member and inherited-factory imports. Addresses #7821.
-
Preserve endpoints whose static path segments collide after name sanitization, such as /v1.1 and /v11. #7143
-
Ruby: a path with an escaped suffix, such as
/domains/{domainName}!quote, generated a request builder method that passed the raw path parameter name where the signature had snake cased it, and referenced the builder class without its namespace. Both raisedNameErroron first use. #7956 -
TypeScript:
GetTypeAliasrebuilt the set of usings of the enclosing block for every type reference written, so the cost of the file writing step grew quadratically with the number of models in aCodeFile. That set is now gathered once per block, while the alias of each using is still read on every lookup. On the GitHub API description this drops the writing step from 19.5 s to 1.9 s, and on the Stripe description from 93.5 s to 7.8 s, with byte-identical output. -
Ruby: generated clients can now execute every response shape. The request adapter was only ever called with
send_async, so a void operation raisedfactory cannot be null, a binary one raised on an undefinedBinaryconstant, a scalar or primitive collection emitted a bare lowercase type name, and a collection of models silently returned a single empty model. Enum collections, scalar and binary request bodies, and theint64,double,decimal,int8,uint8and base64 formats are handled too. Requires the runtime gems at 0.22.0. kiota-ruby#42 kiota-ruby#54 kiota-ruby#67 kiota-ruby#125 #7956 -
Go: nullable UUID path parameters now dereference the pointer before calling
String(), so generated request builders compile. -
Ruby: a composed type without a discriminator generated
parse_node.get_child_node(""), which raises, and composed type wrappers referenced their member classes unqualified so the constants did not resolve. Completes the composed type support added in #8065. kiota-ruby#73 -
Fixed TypeScript request metadata to use string response factories for UUID values and collections.
-
TypeScript: a composed type holding one of the runtime primitives imported from
@microsoft/kiota-abstractions(Guid,DateOnly,TimeOnly,Duration) generated a client that did not compile, witherror TS1361: 'DateOnly' cannot be used as a value because it was imported using 'import type'. The serializer narrows those types with `instan...
v1.29.2
Changed
- Fixed a code injection vulnerability in Java and PHP doc comments by neutralizing block comment delimiters instead of deleting them. #8017 GHSA-rm89-rhwj-9j92
v1.35.0-preview.202609100001
Added
Changed
-
Fixed TypeScript request metadata to use string response factories for UUID values and collections.
-
Fixed the generation of a schema used in two roles at once: as the schema of an error response and as an
allOfchild in the discriminator mapping of another error schema. The error refiner replaced itsallOfbase class with the language error base class while the parent's factory method still returned it as a derived type, so the generated C# and Java clients did not compile (CS0029/incompatible types). Such a schema now keeps its base class and inherits the error base class through its parent, like every other mapped child. -
Dart: an error model's constructor declared the named
additionalDataparameter asrequired, but the generated callers never pass it — inherited error models call a baresuper()andcreateFromDiscriminatorValueinstantiates the class without arguments — so a document with a discriminated error hierarchy generated a client that did not compile. The parameter is now optional and defaults to an empty map in the initializer list. -
Dart: models whose names differ only in where a separator falls (e.g. the inline property type
Process_errorand the component schemaProcessError) snake-cased to the same file name, so one silently overwrote the other and the client did not compile (Undefined class 'Process_error'). Colliding file names are now disambiguated, leaving the generated type names unchanged. Same defect as the one fixed for Ruby, part of #7821. -
Name correction now walks the code model in a fixed order. Where two names correct to the same value only the element reached first can take it, and the walk followed a dictionary whose order varies between runs, so the winner, and with it the generated output, differed from one run to the next. This removes one source of the non-reproducible generation tracked in #7997; other sources remain, so the descriptions suppressed for it stay suppressed.
-
Ruby: a model sharing its name with a sibling namespace had the disambiguation suffix applied once per reference to it rather than once, so generation failed with
The element to rename was not found available_phone_number_countryModelModelModelModel. The reference pass was removed:CodeType.Namealready delegates to the type definition, so references follow the rename on their own. Un-suppresses the Twilio integration and idempotency tests. kiota-abstractions-ruby#66 -
C#: create property "EqualsEscaped" instead of "Equals" for model properties "equals" to avoid a compiler warning #8133
-
A HEAD operation with no response schema generated an executor returning a
Stream. The default return type was picked from the response codes alone, so a HEAD declaring only a200fell through to binary, while one that happened to list304returned void by accident. The request method is now checked first, so a HEAD that falls through to the default returns void. #4245
v1.35.0
Added
- Added model generation for schemas used by OpenAPI 3.1 webhooks. #6394
- Adds support for resolving JSON Schema 2020-12
$dynamicRefagainst schemas declaring$dynamicAnchor, so recursive types (e.g.LocalizedCategory.children: LocalizedCategory[]) generate correctly instead of degrading toUntypedNode. Phase 1 of #7815. - Added binding-aware
$dynamicRefresolution for$defs/$dynamicAnchorcontexts, generating distinct concrete models for each active binding and preserving typed request bodies, responses, and error responses. Phase 2 of #7815.
Changed
- Go: fixed the factory reference emitted for a model whose name ends in
able(e.g.ProviderUnavailable): the writer trimmed the suffix as if it were the model-interface suffix, referencing aCreate...FromDiscriminatorValuesymbol that is never generated, so the package did not compile. The suffix is now only trimmed when the type resolves to the inserted interface. - Fixed query parameters whose name is escaped (e.g.
exportin TypeScript) being silently dropped from the request: the original name is now kept as the serialization name, so TypeScript emits thequeryParametersMapperentry mapping the escaped symbol back to its wire name. kiota-typescript#2111 - Fixed defaults primitive default-value handling during code generation for all languages
- Ruby: added composed type (union/intersection) support to the factory, serializer and deserializer bodies, and stopped emitting composed type wrappers as inner classes. Un-suppresses the Twitter integration test. kiota-abstractions-ruby#73 #1816
- Ruby:
initializeis now a reserved name. An API member calledinitializepreviously generated a seconddef initialize, redefining the constructor; it is now escaped. - Ruby: removed the blank line emitted at the start of every generated class body.
- Ruby: moved the runtime gem dependencies to 0.19.0, the first release able to serialize a primitive composed type member and to tell which member a payload holds.
- Ruby: models whose names differ only in where a separator falls (e.g.
codeScanningVariantAnalysis_statusandcodeScanningVariantAnalysisStatus) snake-cased to the same file name, so one silently overwrote the other and the models barrel required it twice. Colliding file names are now disambiguated, leaving the generated type names unchanged. Un-suppresses the GitHub integration test. #1816 - Ruby: fixed flattening of models nested more than one namespace deep. The separators were emitted into the class name, producing invalid constants such as
class S.v2.billingMeterEvent, and the models namespace was itself renamed part-way through the walk, prefixing every nested model with a fragment of it (s_v2_billing_meter_event). Un-suppresses the Stripe integration and idempotency tests. #1816 - Fixed plugin manifest generation to omit unsafe
oauth_card_pathfile references that could resolve outside the plugin package. - Bumped
Microsoft.OpenApiandMicrosoft.OpenApi.YamlReaderto 3.10.2, and lifted the YAML reader scalar length limit so descriptions with large scalars (e.g. long markdown descriptions) can still be parsed. - Numeric scalar unions with a format (e.g.
type: ["integer", "string"]withformat: int32, as emitted by ASP.NET Core's OpenAPI 3.1 generator under System.Text.Json's defaultJsonNumberHandling.AllowReadingFromString) now map to the numeric type instead of degrading toUntypedNode. #6541 - Ruby: removed
thenfrom multilineunlessand skipped emptycaseblocks in factory methods to fix RuboCop and SyntaxError offenses. kiota-abstractions-ruby#66 #7856 - Ruby: fixed enum default values with numeric wire names (e.g.
2.0) to use the enum option name instead of the raw value as a Ruby symbol. kiota-abstractions-ruby#66 - Ruby: fixed
case/whenindentation and added empty line afterattr_accessorto resolve RuboCop offenses in generated code. kiota-abstractions-ruby#59 - golang: generated code now always uses LF line endings, so
gofmtno longer reports formatting differences when generating on Windows. - golang: make sure all generated code adheres to golangs coding standards
- Fixed non-deterministic model class descriptions when a component schema is referenced from multiple properties with differing reference-level descriptions. #7927
- Fixed generation of a spurious union type/wrapper for
oneOfnullable reference types (e.g.oneOf: [$ref, {type: null}]as emitted by ASP.NET Core 10's OpenAPI 3.1 generator); these now collapse to the nullable target type, matching the existinganyOfbehavior. #6776 - TypeScript: fixed generation for primitive binary unions by handling
ArrayBufferas a primitive type, and deduplicated redundant serialization/deserialization branches when multiple union members map to the same runtime type (e.g.binaryandbase64). - TypeScript: fixed composed type deserialization for unions that include Kiota primitive types such as
DateOnly. - C#: write
#pragmato disable CS1591 for properties without description. #8095 - C#: don't create
<see cref="byte[]"/>xml doc comments #8099 - Required array query parameters with
explode: true(the OpenAPI default for query parameters) now use the exploded form expansion ({?param*}) in URL templates so each value repeats the key, instead of the required syntaxparam={param}which comma joins the values. Required scalar query parameters keep the required syntax since scalar expansion is identical either way. Note the tradeoff RFC 6570 forces here: a required exploded array left unset now disappears from the query string entirely instead of emitting a bareparam=pair. #8031 #4487
v1.29.1
Added
- Added the
--allowed-external-originsparameter to commands that load OpenAPI descriptions. External references are now not loaded by default to improve security; use this parameter to allow*, full URIs, URI patterns, full paths, relative paths, or path patterns. #7888 GHSA-rg4h-fpcp-2qm8 / CVE-2026-59867
Changed
- Removed support for specifying dependency install commands through the
x-ms-kiota-infoOpenAPI description extension. #7883 - Fixed a code generation literal injection vulnerability affecting nearly every language writer. #7603 GHSA-2hx3-vp6r-mg3f / CVE-2026-41134
- Fixed a code injection vulnerability in Python generation via
x-ms-enumdescription newlines. #7735 GHSA-7f3j-j7jj-r3vr / CVE-2026-59862 - Fixed a code injection vulnerability in Ruby generation via unescaped
#interpolation markers. #7746 GHSA-xg2h-5xr2-29jw / CVE-2026-59861 - Fixed a code injection vulnerability in C# doc comments via unescaped newlines. #7831 GHSA-3hrf-2gc2-mx32 / CVE-2026-59860
- Fixed a code injection vulnerability in PHP generation by escaping
$in double-quoted string literals. #7863 GHSA-jqwh-526h-c92j / CVE-2026-59859 - Sanitized client class and namespace names loaded from settings or the
x-ms-kiota-infoOpenAPI extension before using them in generated code and file paths. #7884 GHSA-4vv7-jj25-4gh6 / CVE-2026-59866 - Workspace client and plugin generation now rejects workspace configuration entries whose
outputPathis rooted or escapes the workspace. #7885 GHSA-4rj6-vrwv-wr8m / CVE-2026-59863 - Plugin manifest generation now rejects
static_template.filereferences that escape the output directory. #7892 GHSA-4jwf-m4wg-8p66 - Bumped the OpenTelemetry packages from 1.13.1 to 1.15.3 to pick up their security fixes. GHSA-4625-4j76-fww9, GHSA-mr8r-92fq-pj8p, GHSA-q834-8qmm-v933
- Bumped
Microsoft.OpenApiandMicrosoft.OpenApi.YamlReaderfrom 2.0.0 to 2.12.0, which picks up their security fixes (GHSA-v5pm-xwqc-g5wc). This also fixes resolution of allowed external references, which previously failed with a spurious circular reference error. - Plugin descriptions: a union of primitive types, such as
anyOf: [string, integer], is now narrowed to a single type. A numeric type paired with a string and a numeric format, the shape System.Text.Json'sJsonNumberHandling.AllowReadingFromStringproduces, resolves to the numeric type, otherwise the string type wins.Microsoft.OpenApi2.12.0 folds such unions into a single multi-valued type before kiota sees them, and that fold does not preserve the order the types were declared in, so the previous "take the first entry" behaviour can no longer be applied literally.
v1.34.1
Added
Changed
- Reduced the aggressiveness of namespace segment and type name shortening by raising the length threshold to 200 characters, so only names longer than 200 characters are truncated (to a 191-character prefix plus an underscore and 8-character hash). The threshold stays well below the 255 file-system per-component limit to leave room for extensions and language-specific suffixes appended by path segmenters and compilers (e.g. Java nested-class
.classfiles and the extra underscores Python adds when converting names to snake_case).
v1.34.0
Changed
Fixed a path traversal vulnerability where workspace consumer identifiers (clientName/pluginName) and workspace configuration keys were used as filesystem path components without containment validation, allowing a crafted name (e.g. junk/../Victim) to overwrite another consumer's cached OpenAPI description. #7919
Full Changelog: v1.33.0...v1.34.0