|
| 1 | +--- |
| 2 | +title: "Open Workflow SDK Go 4.0.0" |
| 3 | +author: "Ricardo Zanini" |
| 4 | +date: "2026-07-14" |
| 5 | +description: >- |
| 6 | + Open Workflow SDK Go 4.0.0 is here — the Go SDK moves to its new home under the Open Workflow Specification organization with a fresh module path and updated branding. |
| 7 | +--- |
| 8 | + |
| 9 | +## Announcing the Release of Open Workflow SDK Go 4.0.0 |
| 10 | + |
| 11 | +We are excited to announce **Go SDK 4.0.0**, the first release under the **Open Workflow Specification** organization. This release marks the project's transition from "Serverless Workflow" to **Open Workflow**, reflecting the broader scope of the specification. |
| 12 | + |
| 13 | +👉 Full release notes: [GitHub – v4.0.0](https://github.com/open-workflow-specification/sdk-go/releases/tag/v4.0.0) |
| 14 | + |
| 15 | +--- |
| 16 | + |
| 17 | +## What's New in 4.0.0? |
| 18 | + |
| 19 | +This release focuses on the rebranding — there are **no API or schema changes** from the v3.x line. The specification conformance remains at **v1.0.0**. |
| 20 | + |
| 21 | +### New GitHub Home |
| 22 | + |
| 23 | +The SDK now lives at [github.com/open-workflow-specification/sdk-go](https://github.com/open-workflow-specification/sdk-go). GitHub redirects from the old URL are in place, so existing links and references to v3.x releases continue to work. |
| 24 | + |
| 25 | +### Updated Go Module Path |
| 26 | + |
| 27 | +The module path has changed to reflect the new organization: |
| 28 | + |
| 29 | +``` |
| 30 | +github.com/open-workflow-specification/sdk-go/v4 |
| 31 | +``` |
| 32 | + |
| 33 | +### Updated Error Type URIs |
| 34 | + |
| 35 | +Standard error type URIs now use the `open-workflow-specification.org` domain: |
| 36 | + |
| 37 | +``` |
| 38 | +https://open-workflow-specification.org/spec/1.0.0/errors/validation |
| 39 | +https://open-workflow-specification.org/spec/1.0.0/errors/authentication |
| 40 | +... |
| 41 | +``` |
| 42 | + |
| 43 | +--- |
| 44 | + |
| 45 | +## Migration Guide |
| 46 | + |
| 47 | +Upgrading from v3.x is straightforward — update your imports and run `go get`: |
| 48 | + |
| 49 | +1. Update your import paths: |
| 50 | + |
| 51 | + ```go |
| 52 | + // Before |
| 53 | + import "github.com/serverlessworkflow/sdk-go/v3/parser" |
| 54 | + import "github.com/serverlessworkflow/sdk-go/v3/impl" |
| 55 | + |
| 56 | + // After |
| 57 | + import "github.com/open-workflow-specification/sdk-go/v4/parser" |
| 58 | + import "github.com/open-workflow-specification/sdk-go/v4/impl" |
| 59 | + ``` |
| 60 | + |
| 61 | +2. Fetch the new module: |
| 62 | + |
| 63 | + ```bash |
| 64 | + go get github.com/open-workflow-specification/sdk-go/v4 |
| 65 | + ``` |
| 66 | + |
| 67 | +3. If your code references error type URIs (e.g., `https://serverlessworkflow.io/spec/1.0.0/errors/...`), update them to `https://open-workflow-specification.org/spec/1.0.0/errors/...`. |
| 68 | + |
| 69 | +4. Run your tests to verify the transition: |
| 70 | + |
| 71 | + ```bash |
| 72 | + go test ./... |
| 73 | + ``` |
| 74 | + |
| 75 | +--- |
| 76 | + |
| 77 | +## What's Next |
| 78 | + |
| 79 | +The reference implementation continues to grow. Check out the [implementation roadmap](https://github.com/open-workflow-specification/sdk-go#implementation-roadmap) to see what's supported and where you can contribute. |
| 80 | + |
| 81 | +--- |
| 82 | + |
| 83 | +## Community |
| 84 | + |
| 85 | +The project remains under **CNCF** governance. Join us on the CNCF Slack in the `#open-workflow-sdk` channel to collaborate, ask questions, and contribute. |
| 86 | + |
| 87 | +* Issues & feedback: [github.com/open-workflow-specification/sdk-go/issues](https://github.com/open-workflow-specification/sdk-go/issues) |
| 88 | +* Specification: [github.com/open-workflow-specification/specification](https://github.com/open-workflow-specification/specification) |
| 89 | + |
| 90 | +Thank you to everyone who contributed to this milestone release! |
0 commit comments