# November 13, 2025

## 1.1.0

**`(feat):`** Add `path-parameter-order`, which configures how path parameters are ordered in generated code.
If set to `url-order` (the default), path parameters are ordered in the same order as they appear in the URL.
If set to `spec-order`, path parameters are ordered in the same order as they are listed in the spec.

Can be configured as follows in `generators.yml`:

```yaml
api:
  settings:
    path-parameter-order: url-order
```

## 1.0.2

**`(fix):`** Display OpenAPI validation warnings when using the --warnings flag with fern check. Previously, warnings were counted but not shown; now they are logged with location details when --warnings is specified.

## 1.0.1

**`(fix):`** Update OpenAPI operation converter to use `x-fern-explorer` extension instead of `x-fern-explorer-enabled` for setting `apiPlayground` property in the IR. Operations now check for the `x-fern-explorer` boolean value to determine API playground availability.

## 1.0.0

**`(feat):`** Change defaults for OpenAPI and AsyncAPI parsing settings:

* `title-as-schema-name`: `false` (was `true`)
* `respect-nullable-schemas`: `true` (was `false`)
* `inline-path-parameters`: `true` (was `false`)
* `idiomatic-request-names`: `true` (was `false`)
* `type-dates-as-strings`: `true` (was `false`)
* `wrap-references-to-nullable-in-optional`: `false` (was `true`)
* `coerce-optional-schemas-to-nullable`: `false` (was `true`)
* `object-query-parameters`: `true` (was `false`)
  The CLI will automatically upgrade your *generators.yml* to explicitly set the old defaults to preserve
  existing behavior. New users will get the new defaults.

## 0.121.2

**`(chore):`** Refactor how settings from specs are parsed and applied in the CLI.

## 0.121.1

**`(feat):`** Match endpoints to AI overrides examples.

## 0.121.0

**`(feat):`** Add batching support for AI example enhancement. The CLI now processes up to 10 endpoints at once with a single pruned OpenAPI spec, improving performance. Non-OpenAPI specs are automatically skipped.

## 0.120.0

**`(break):`** Rename OpenAPI extensions: x-fern-playground → x-fern-explorer and x-fern-playground-enabled → x-fern-explorer-enabled. The old extension keys are no longer recognized.