Skip to content

Releases

v1.38.0

Choose a tag to compare

@adrian05-ms adrian05-ms released this 02 Nov 22:10
5600320

Added

Changed

  • Python: check inherited-model discriminators once before type dispatch to avoid repeated truthiness checks that cause excessive CodeQL extraction work in large factories.

v1.37.0

Choose a tag to compare

@adrian05-ms adrian05-ms released this 30 Oct 01:16
f31297c

Added

  • Ruby: a deprecated operation, path, model, enum, property or parameter carries a YARD @deprecated tag with the description's deprecation text, date, removal date and version. Calling a deprecated method or navigating to a deprecated path also warns with category: :deprecated, which Ruby prints when Warning[:deprecated] is on, as it does for its own deprecations. kiota-ruby#64
  • Ruby: models generated with --backing-store keep 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-store generated 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-urlencoded and multipart/form-data bodies 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 /legacy under a live /api was 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 info lists the runtime gems at 0.25.0.

v1.36.1

Choose a tag to compare

@adrian05-ms adrian05-ms released this 12 Oct 19:39
fd3bf87

Added

Changed

  • Fixed small issues with release pipelines

v1.36.0

Choose a tag to compare

@adrian05-ms adrian05-ms released this 09 Oct 22:21
4f83de5

Added

  • Ruby: an error's message returns the property the description marks with x-ms-primary-error-message, as the other languages do. An error property named message is renamed message_escaped, like MessageEscaped in C#; when it is a string, message still 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 oneOf or anyOf member defines its properties only through allOf. 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 allOf schemas.

  • 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 allOf wrappers, 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-payment or read is sent and read as the description declares it instead of as IncomingPayment or Read. 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 allOf schemas, 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 as integration_test.client, failed to load because its root file was written one directory too deep.

  • Ruby: namespace barrels register their models and enums with autoload instead 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" warnings ruby -w printed 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, base64 or base64url keeps 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 node or deserializerMap during deserialization so local variables do not shadow them; escape override model 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 raised NameError on first use. #7956

  • TypeScript: GetTypeAlias rebuilt 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 a CodeFile. 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 raised factory cannot be null, a binary one raised on an undefined Binary constant, 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 the int64, double, decimal, int8, uint8 and 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, with error TS1361: 'DateOnly' cannot be used as a value because it was imported using 'import type'. The serializer narrows those types with `instan...

Read more

v1.29.2

Choose a tag to compare

@adrian05-ms adrian05-ms released this 09 Oct 21:47
v1.29.2
aed3599

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

Pre-release

Choose a tag to compare

@jingjingjia-ms jingjingjia-ms released this 10 Sep 19:22
ec03ed1

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 allOf child in the discriminator mapping of another error schema. The error refiner replaced its allOf base 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 additionalData parameter as required, but the generated callers never pass it — inherited error models call a bare super() and createFromDiscriminatorValue instantiates 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_error and the component schema ProcessError) 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.Name already 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 a 200 fell through to binary, while one that happened to list 304 returned 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

Choose a tag to compare

@jingjingjia-ms jingjingjia-ms released this 04 Sep 00:04
114aa7e

Added

  • Added model generation for schemas used by OpenAPI 3.1 webhooks. #6394
  • Adds support for resolving JSON Schema 2020-12 $dynamicRef against schemas declaring $dynamicAnchor, so recursive types (e.g. LocalizedCategory.children: LocalizedCategory[]) generate correctly instead of degrading to UntypedNode. Phase 1 of #7815.
  • Added binding-aware $dynamicRef resolution for $defs / $dynamicAnchor contexts, 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 a Create...FromDiscriminatorValue symbol 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. export in TypeScript) being silently dropped from the request: the original name is now kept as the serialization name, so TypeScript emits the queryParametersMapper entry 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: initialize is now a reserved name. An API member called initialize previously generated a second def 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_status and codeScanningVariantAnalysisStatus) 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_path file references that could resolve outside the plugin package.
  • Bumped Microsoft.OpenApi and Microsoft.OpenApi.YamlReader to 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"] with format: int32, as emitted by ASP.NET Core's OpenAPI 3.1 generator under System.Text.Json's default JsonNumberHandling.AllowReadingFromString) now map to the numeric type instead of degrading to UntypedNode. #6541
  • Ruby: removed then from multiline unless and skipped empty case blocks 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/when indentation and added empty line after attr_accessor to resolve RuboCop offenses in generated code. kiota-abstractions-ruby#59
  • golang: generated code now always uses LF line endings, so gofmt no 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 oneOf nullable 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 existing anyOf behavior. #6776
  • TypeScript: fixed generation for primitive binary unions by handling ArrayBuffer as a primitive type, and deduplicated redundant serialization/deserialization branches when multiple union members map to the same runtime type (e.g. binary and base64).
  • TypeScript: fixed composed type deserialization for unions that include Kiota primitive types such as DateOnly.
  • C#: write #pragma to 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 syntax param={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 bare param= pair. #8031 #4487

v1.29.1

Choose a tag to compare

@baywet baywet released this 14 Aug 15:38
v1.29.1
2675c4a

Added

  • Added the --allowed-external-origins parameter 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-info OpenAPI 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-enum description 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-info OpenAPI 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 outputPath is rooted or escapes the workspace. #7885 GHSA-4rj6-vrwv-wr8m / CVE-2026-59863
  • Plugin manifest generation now rejects static_template.file references 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.OpenApi and Microsoft.OpenApi.YamlReader from 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's JsonNumberHandling.AllowReadingFromString produces, resolves to the numeric type, otherwise the string type wins. Microsoft.OpenApi 2.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

Choose a tag to compare

@jingjingjia-ms jingjingjia-ms released this 09 Jul 19:52
9f9cfb3

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 .class files and the extra underscores Python adds when converting names to snake_case).

v1.34.0

Choose a tag to compare

@gavinbarron gavinbarron released this 08 Jul 20:03
9d4f80e

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