> For the complete documentation index, see [llms.txt](https://docs.layerlens.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.layerlens.ai/13.1-sdk-and-apis/migrating-sdk-versions.md).

# Migrating SDK versions

Migrate between Stratix SDK versions — breaking changes and replacement paths.

The SDK follows semver. Breaking changes are major-version bumps. Within a major, additions only.

## v1.2 → v1.3

**Additions:**

* `client.judge_optimizations` (GEPA) — new namespace
* `client.trace_evaluations.create(..., trace_set={...})` — new param

No breaking changes. Upgrade is drop-in.

## v1.1 → v1.2

**Additions:**

* `client.spaces` — new namespace
* Improved retry semantics

No breaking changes.

## Pinning

Production: pin exact version.

```bash
pip install layerlens --extra-index-url https://sdk.layerlens.ai/package==1.3.0
```

Development: pin the minor.

```bash
pip install "layerlens>=1.3.0,<1.4.0"
```

## See also

* [Versioning](https://github.com/LayerLens/gitbook-full/blob/main/13-reference/sdk-python/versioning.md)
* [SDK release notes](https://github.com/LayerLens/gitbook-full/blob/main/13-reference/sdk-python/release-notes-sdk.md)
* [Platform release notes](/6.-build-wire-your-code/sdk-python.md)