# Meshery v1.0.2

2026-04-07 · [Original release notes](https://github.com/meshery/meshery/releases/tag/v1.0.2) · [Full summary](https://ratatosk.io/en/releases/meshery/v1.0.2)

Breaking changes 3 · Important fixes 2 · Enhancements 2 · Dependency updates 3 · Other changes 10

## Breaking changes (3)

### Workspace updates preserve fields for empty values

- Affects: workspace updates through `PUT /api/workspaces/{id}`

Previously, requests to `PUT /api/workspaces/{id}` overwrote the name, description, and organization from the payload unconditionally. Now, an omitted name, empty description, or nil organization leaves the stored value unchanged.

Evidence: “- Use `WorkspaceUpdatePayload` for `PUT /api/workspaces/{id}` (name optional on update)” https://github.com/meshery/meshery/pull/18541

> - Upgrade to Meshery Schemas v1.0.4: enhance Workspace API @yi-nuo426 (#18541)

### Workspace and environment fetching fixed for `orgID`

- Affects: workspace and environment handler calls that use the `orgID` query parameter

When callers supplied `orgID`, handlers looked for `orgId`, so the provider omitted the organization ID and Cloud returned HTTP 500. They now pass the supplied value to the provider; requests with an empty `orgID` return HTTP 400.

> - Fix orgID query parameter case in workspace and environment handlers @yi-nuo426 (#18519)

### Local Swagger UI and `swagger.yaml` serving removed

- Affects: Meshery server installations using the local Swagger UI or `swagger.yaml` endpoints (Inferred)

The REST API reference now points to the published schemas site and the `meshery/schemas` repository.

Evidence: “Replaced the embedded/generated reference with links to the published schemas site and the `meshery/schemas` repository.” https://github.com/meshery/meshery/pull/18521

> - Retire swagger-based REST API docs and point references to meshery/schemas @[copilot-swe-agent[bot]](https://github.com/apps/copilot-swe-agent) (#18521)
> - Retire swagger-based REST API docs and point references to meshery/schemas @[copilot-swe-agent[bot]](https://github.com/apps/copilot-swe-agent) (#18521)

## Important fixes (2)

### Meshery UI environment query mapping fixes console 404s

- Affects: Meshery UI environment queries (Inferred)

Before the fix, environment queries did not use the repository's expected `orgID` parameter and returned console 404s.

> - [UI] Fix console 404s for environments and icons @yi-nuo426 (#18556)

### Workspace query waits for an organization ID

- Affects: workspace data table in the Meshery UI

Previously, when the workspace query ran before the selected organization was available, it requested `/api/workspaces` without `orgID`; the server's plain-text response caused a client-side JSON parse failure.

> - [UI] Guard workspace query on org availability @yi-nuo426 (#18525)

## Enhancements (2)

- Workspace API adds seven design, view, and team endpoints
- Workspace edit form allows an unchanged `name`

## Dependency updates (3)

3 more, none mentioning security

- `- [Chore]: Update to Sistent v0.18.3 @l5io (#18554) - Bump @sistent/sistent to v0.18.2 and use editWorkspaceSchema @fitzergerald (#18544)`
- `- chore: upgrade meshery/schemas to v1.0.5 @yi-nuo426 (#18550)`
- `- chore(deps): bump vite from 7.3.1 to 7.3.2 in /ui @[dependabot[bot]](https://github.com/apps/dependabot) (#18524)`

## Other changes (10)

- Swagger file copy removed from Dockerfiles
- Meshery migration creates workspace team and view mapping tables
- `mesheryctl` workspace schema handling fixed
- Workspace view output now includes an empty `metadata` field
- Debug prints removed from the workspace persister
- Shared image paths normalized for Meshmodel icons
- Deprecated ESLint option removed from Provider UI’s `next.config.js`
- Deprecated reusable UI and server build workflow removed
- Swagger-generated REST API documentation and local spec tooling retired
- Swagger Make targets and local publishing workflows removed

---

Summaries are produced by AI, so they can be wrong, and they are provided without warranty.
