Tyk Sync Release Notes

Release notes documenting updates, enhancements, fixes and changes for Tyk Sync.

Licensed Protected Product

This page contains all release notes for Sync displayed in a reverse chronological order

Support Lifetime

Our minor releases are supported until our next minor comes out.

---

Note on Tyk Sync version 2.2.1

Tyk Sync 2.1.1 was accidentally also released to DockerHub as Tyk Sync v2.2.1.
That version should not be used.
We recommend the most recent version of Tyk Sync, which is first in the following list.

2.1 Release Notes

2.1.3 Release Notes

Release Date 4 September 2025

Release Highlights

This patch release upgrades Tyk Sync to use Go 1.24 for enhanced security and stability.

Please refer to the changelog below for detailed explanation.

Breaking Changes

This release has no breaking changes.

Deprecations

There are no deprecations in this release.

Upgrade instructions

For users currently on v2.1.2, we strongly recommend promptly upgrading to the latest release. If you are working with an older version, it is advisable to bypass version 2.1.2 and proceed directly to this latest patch release.

Go to the Upgrading Tyk section for detailed upgrade Instructions.

Downloads

• Docker image v2.1.3
  • docker pull tykio/tyk-sync:v2.1.3
    

Changelog

Updated

• Show Upgraded to Golang 1.24

  Tyk Sync now runs on Golang 1.24, bringing:

  • Improved build performance and runtime efficiency
  • Enhanced security with latest Go security patches
  • Better dependency management and module support

2.1.2 Release Notes

Release Date 27 June 2025

Release Highlights

This patch release uplifts a dependent library for better interoperability with the rest of the Tyk stack. Please refer to the changelog below for detailed explanation.

Breaking Changes

This release has no breaking changes.

Deprecations

There are no deprecations in this release.

Upgrade instructions

For users currently on v2.1.1, we strongly recommend promptly upgrading to the latest release. If you are working with an older version, it is advisable to bypass version 2.1.1 and proceed directly to this latest patch release.

Go to the Upgrading Tyk section for detailed upgrade Instructions.

Downloads

• Docker image v2.1.2
  • docker pull tykio/tyk-sync:v2.1.2
    

Changelog

Updated

• Show Updated to use latest kin-openapi

  Upgraded to use the latest version of kin-openapi (v0.132.0). This ensures improved compatibility, full stack interoperability, and continued support for existing OpenAPI 3.0.x specifications.

2.1.1 Release Notes

Release Date 13 May 2025

Release Highlights

This patch release contains a bug fix. Please refer to the changelog below for detailed explanation.

This release was accidentally also released to DockerHub as Tyk Sync v2.2.1. That version should not be used.

Breaking Changes

This release has no breaking changes.

Deprecations

There are no deprecations in this release.

Upgrade instructions

For users currently on v2.1.0, we strongly recommend promptly upgrading to the latest release. If you are working with an older version (lower major), it is advisable to bypass version 2.1.0 and proceed directly to this latest patch release.

Go to the Upgrading Tyk section for detailed upgrade Instructions.

Downloads

• Docker image v2.1.1
  • docker pull tykio/tyk-sync:v2.1.1
    

Changelog

Fixed

• Show Fixed incorrect API-level rate limits from dump command

  Fixed an issue where the Tyk Sync dump command incorrectly set API-level rate limits in a policy that did not have such limits. This problem arose from Sync trying to add a default value when no rate limit is set in the policy, which led to unintended rate limiting. The issue has been resolved by ensuring that Sync respects the original policy when no API-level rate limit is set.

2.1.0 Release Notes

Release Date 28 March 2025

Release Highlights

Tyk Sync 2.1 introduces performance improvements and enhanced control over API synchronization. This release optimizes resource updates, adds support for partial synchronization, and ensures compatibility with Tyk 5.8.

Please refer to the changelog below for detailed explanation.

Breaking Changes

This release has no breaking changes.

Deprecations

There are no deprecations in this release.

Upgrade instructions

For users currently on v2.0.0, we strongly recommend promptly upgrading to the latest release. If you are working with an older version (lower major), it is advisable to bypass version 2.0.0 and proceed directly to this latest patch release.

Go to the Upgrading Tyk section for detailed upgrade Instructions.

Downloads

• Docker image v2.1.0
  • docker pull tykio/tyk-sync:v2.1.0
    

Changelog

Added

• Show --no-delete flag for partial synchronization

  Added a —no-delete flag to prevent resource deletion during partial sync, giving users more control over API synchronization.

• Show Parallel processing for improved performance

  Improved synchronization speed by adding parallel processing, allowing faster execution of sync operations in large environments.

Changed

• Updated API definitions

  Updated API definitions for full compatibility with Tyk 5.8, ensuring seamless integration with the latest Gateway and Dashboard features.

  Distroless Docker Image

  Changed the Tyk Sync Docker image to a distroless base starting from version 2.1.0, reducing potential security vulnerabilities and minimizing the image size.

  Tyk Sync updated to use Golang 1.23

  Tyk Sync is using Golang 1.23 Programming Language starting with the 2.1.0 release. This brings improvements to the code base and allows us to benefit from the latest features and security enhancements in Go.

Fixed

• Show Optimized API update requests

  Fixed an issue where API synchronization was unnecessarily sending update or create requests to the Dashboard even when no changes were detected. This caused redundant operations and inefficiencies in large-scale deployments. The system now intelligently detects actual changes before making requests, optimizing performance.

2.0 Release Notes

2.0.4 Release Notes

Release Date 14 February 2025

Release Highlights

Tyk Sync 2.0.4 has been updated to fix a critical security vulnerability.

Please refer to the changelog below for detailed explanation.

Breaking Changes

This release has no breaking changes.

Deprecations

There are no deprecations in this release.

Upgrade instructions

For users currently on v2.0.0, we strongly recommend promptly upgrading to the latest release. If you are working with an older version (lower major), it is advisable to bypass version 2.0.0 and proceed directly to this latest patch release.

Go to the Upgrading Tyk section for detailed upgrade Instructions.

Downloads

• Docker image v2.0.4
  • docker pull tykio/tyk-sync:v2.0.4
    

Changelog

Fixed

• Show CVE-2025-21613 resolved in Tyk Sync

  Resolved CVE-2025-21613 by updating the go-git library to v5.13.2. go-git is a highly extensible git implementation library written in pure Go. An argument injection vulnerability was discovered in go-git versions prior to v5.13. Successful exploitation of this vulnerability could allow an attacker to set arbitrary values to git-upload-pack flags. This only happens when the file transport protocol is being used, as that is the only protocol that shells out to git binaries. This vulnerability is fixed in 5.13.0.

2.0.1 Release Notes

Release Date 05 December 2024

Release Highlights

Tyk Sync 2.0.1 has been updated to support API configurations from Tyk 5.7.0.

Please refer to the changelog below for detailed explanation.

Breaking Changes

This release has no breaking changes.

Deprecations

There are no deprecations in this release.

Upgrade instructions

For users currently on v2.0.0, we strongly recommend promptly upgrading to the latest release. If you are working with an older version (lower major), it is advisable to bypass version 2.0.0 and proceed directly to this latest patch release.

Go to the Upgrading Tyk section for detailed upgrade Instructions.

Downloads

• Docker image v2.0.1
  • docker pull tykio/tyk-sync:v2.0.1
    

Changelog

Changed

• Show API definitions and policies supported up to Tyk Gateway v5.7.0

  Tyk Sync 2.0.1 supports API definitions and policies up to Tyk Gateway v5.7.0. This update ensures that Tyk Sync can manage API definitions and policies compatible with Tyk Gateway v5.7.0.

Fixed

• Show Improved Error Handling for Invalid MongoDB Object IDs in Tyk Sync

  Addressed an issue where Tyk Sync did not properly validate MongoDB Object IDs during API synchronization. Previously, invalid IDs would result in silent failures, causing APIs to remain unpublished without error logs, creating confusion for users. Tyk Sync now logs meaningful error messages and exits with an error if invalid IDs are detected. This fix enhances the reliability and transparency of the synchronization process, ensuring consistent behavior with the Tyk Dashboard API.

---

2.0.0 Release Notes

From Tyk Sync v2.0, Tyk Sync will be closed source and we will only support use of Tyk Sync with licensed Tyk Dashboard.

Release Date 10 Oct 2024

Release Highlights

Tyk Sync 2.0 has been updated to support API configurations from Tyk 5.6.0.

Please refer to the changelog below for detailed explanation.

Breaking Changes

This release has no breaking changes.

Deprecations

Deprecation of --gateway Flag

As of Tyk Sync v2.0, support for the Open Source Tyk Gateway has been removed. Tyk Sync v2.0 is now compatible exclusively with licensed Tyk Dashboard. This change means that Tyk Sync can no longer be used with the Open Source (OSS) version of the Tyk Gateway.

The --gateway flag, previously used to sync with the OSS Tyk Gateway, is deprecated and will be fully removed in a future release. Users should prepare to transition their Tyk Sync workflows to licensed Tyk Dashboard environments to ensure continued functionality.

Future deprecations

As part of our ongoing efforts to streamline and improve Tyk Sync, we plan to deprecate the following options in future releases:

• --apis for the tyk-sync sync command.
• --policies for the tyk-sync sync command.

We recommend users update their workflows to use the publish and update commands for managing individual API and Policy IDs. To continue using the sync command, ensure all required resources are listed in the .tyk.json index file. This file will serve as the source of truth for API configuration states, and Tyk Sync will create or update all specified resources while removing any others from Tyk Dashboard.

Upgrade instructions

Go to the Upgrading Tyk section for detailed upgrade Instructions.

Downloads

• Docker image v2.0.0
  • docker pull tykio/tyk-sync:v2.0.0
    

Changelog

Updated

• Show API definitions and policies supported up to Tyk Gateway v5.6.0

  Tyk Sync 2.0.0 supports API definitions and policies up to Tyk Gateway v5.6.0. This update ensures that Tyk Sync can manage API definitions and policies compatible with Tyk Gateway v5.6.0.

• Show Deprecated --gateway flag

  As of Tyk Sync v2.0, support for the Open Source Tyk Gateway has been removed. Tyk Sync v2.0 is now compatible exclusively with licensed Tyk Dashboard. This change means that Tyk Sync can no longer be used with the Open Source (OSS) version of the Tyk Gateway.

  The --gateway flag, previously used to sync with the OSS Tyk Gateway, is deprecated and will be fully removed in a future release. Users should prepare to transition their Tyk Sync workflows to licensed Tyk Dashboard environments to ensure continued functionality.

1.5 Release Notes

1.5.1 Release Notes

Release date 13 August 2024

Breaking Changes

This release has no breaking changes.

Deprecations

There are no deprecations in this release.

Upgrade instructions

Go to the Upgrading Tyk section for detailed upgrade Instructions.

Downloads

• Docker image v1.5.1
  • docker pull tykio/tyk-sync:v1.5.1
    

Changelog

Fixed

• Show Fixed problem in synchronizing APIs with duplicate slugs

  In previous versions, the sync command in Tyk Sync checked for duplicate slugs among APIs. As slugs are now deprecated and APIs will have identical slugs by default starting from Tyk v5.3, this check became problematic. To resolve this, the checks for duplicate slugs have been removed in this version, ensuring compatibility with both Tyk Cloud and Tyk v5.3+.

Changed

• Show API definitions supported up to Tyk Gateway v5.5.0

  Tyk Sync 1.5.1 supports API definitions up to Tyk Gateway v5.5.0. This update ensures that Tyk Sync can manage API definitions compatible with Tyk Gateway v5.5.0.

1.5.0 Release Notes

Release date 4 July 2024

Breaking Changes

This release has no breaking changes.

Deprecations

Removed —allow-unsafe-oas flag

With native support of Tyk OAS APIs in Sync v1.5, we have removed the --allow-unsafe-oas flag from all commands as this flag is no longer required. Users can manage OAS APIs with Tyk Gateway and Dashboard (v5.3.2+) without specifying this flag or setting configurations in the Dashboard. The synchronisation of OAS API Definitions with the Dashboard is now safer and more straightforward.

Future deprecations

As part of our ongoing efforts to streamline and improve Tyk Sync, we plan to deprecate the following options in future releases:

• --apis for the tyk-sync sync command.
• --policies for the tyk-sync sync command.

We recommend users update their workflows to use the publish and update commands for managing individual API and Policy IDs. To continue using the sync command, ensure all required resources are listed in the .tyk.json index file. This file will serve as the source of truth for API configuration states, and Tyk Sync will create or update all specified resources while removing any others from the Gateway or Dashboard.

Upgrade instructions

Go to the Upgrading Tyk section for detailed upgrade Instructions.

Release Highlights

Full support for OAS APIs and API templates

Tyk Sync 1.5 now fully supports Tyk OpenAPI Specification (OAS) APIs and API Templates. This release is compatible with Tyk Gateway or Dashboard version 5.4.0 and above, enabling seamless management of OAS APIs and API templates, and also supports all Tyk API definitions (Tyk OAS APIs and Tyk Classic APIs) for Tyk Gateway and Tyk Dashboard v5.4.0.

For Tyk Gateway v5.4.1+ make sure to use the latest Tyk Sync available and also check Tyk Gateway release notes in the section “Compatibility Matrix For Tyk Components” for further instructions.

Please refer to the changelog below for detailed explanation.

Downloads

• Docker image v1.5.0
  • docker pull tykio/tyk-sync:v1.5.0
    

• Source code

Changelog

Added

• Support for OAS APIs

  Added native support for OAS APIs. Tyk Sync 1.5 now fully supports OpenAPI Specification (OAS) APIs and API Templates. This release is compatible with Tyk Gateway or Dashboard version 5.3.2 and above, enabling seamless management of OAS APIs and API templates. The --allow-unsafe-oas flag is not required anymore for managing OAS APIs.

  Support for API Templates

  Added support for API templates in dump, sync, update, and publish commands. Tyk Sync now supports managing API template resources in Tyk dashboard. Users can use these commands to manage API templates effectively.

  Support for API Categories of OAS APIs

  Added support for API categories in OAS APIs. Users can now include API Category in the API Definition file. Tyk Sync will update the categories of the API accordingly. It improved organization and categorization of APIs, making management more intuitive.

Updated

• Show API definitions supported up to Tyk Gateway v5.4.0

  Tyk Sync 1.5 supports API definitions up to Tyk Gateway v5.4.0. This update ensures that Tyk Sync can manage API definitions compatible with Tyk Gateway v5.4.0.

• Show Removed --allow-unsafe-oas flag

  With native support of Tyk OAS APIs in Sync v1.5, we have removed the --allow-unsafe-oas flag from all commands as this flag is no longer required. Users can manage OAS APIs with Tyk Gateway and Dashboard (v5.3.2+) without specifying this flag or setting configurations in the Dashboard. The synchronisation of OAS API Definitions with the Dashboard is now safer and more straightforward.

Fixed

• Show Improved CI/CD integration by returning non-zero exit codes on failure

  Previously, users had to parse stdout to detect failures, making it difficult to integrate with CI/CD tools. This fix ensures that failure cases return non-zero exit codes, allowing CI/CD pipeline tools to automatically detect and flag errors. This change will streamline CI/CD workflows and improved error detection and handling.

• Show Fixed endpoint issue in update command

  Fixed an issue with the update command where extra slashes in the endpoint caused PUT requests to be misinterpreted as GET requests. Due to extra slashes at the end of the endpoint, PUT calls were being converted to GET calls, resulting in a 200 OK response without actual updates. This issue occurred when the gateway URL was provided instead of the dashboard URL for sync and update commands. The fix now ensured accurate updates and improved reliability of the update command.

1.4 Release Notes

1.4.3 Release Notes

Release date 5 Apr 2024

Breaking Changes

This release has no breaking changes.

Deprecations

There are no deprecations in this release.

Upgrade instructions

If you are using a 1.4.x version, we advise you to upgrade ASAP to this latest release. If you are on an older version, you should skip 1.4.0 and upgrade directly to this release.

Release Highlights

This release works with Tyk Dashboard and Tyk Gateway v5.3.0. As such it supports all Tyk API definitions (Tyk OAS APIs and Tyk Classic APIs) for Tyk Gateway v5.3.0 and Tyk Dashboard

For Tyk Gateway v5.3.1+ make sure to use the latest Tyk Sync available and also check Tyk Gateway release notes in the section “Compatibility Matrix For Tyk Components” for further instructions.

Please refer to the changelog below for detailed explanation.

Downloads

• Docker image v1.4.3
  • docker pull tykio/tyk-sync:v1.4.3
    

• Source code

Changelog

Updated

• Show API definitions supported up to Tyk Gateway v5.3.0

  Tyk Sync supports both Tyk OAS APIs and Tyk Classic APIs when working with Tyk Dashboard. However, to use Tyk Sync to migrate Tyk OAS APIs you would need to set a special config field in Tyk Dashboard and an argument for Tyk Sync. This is a temporary measure provided for early adopters and will be deprecated later when Tyk Sync is updated in a future release to bring you the full Tyk OAS API experience as soon as possible.

  Recommended usage: Tyk Dashboard setting: allow-unsafe-oas Tyk Sync: use the —allow-unsafe-oas when invoking the CLI

  ####### API Category is not yet supported API Categories are a new capability with v5.3.0 of Tyk Dashboard. API Categories are currently not supported in Tyk Sync for Tyk OAS APIs. This means that Tyk Sync will not be able to save the category definition set for the Tyk OAS API. Until we update Tyk Sync you would need to manually recreate the categories in the new environment.

• Show Tyk Sync updated to use [Golang 1.21](https://tip.golang.org/doc/go1.21)

  Tyk Sync is using Golang 1.21 Programming Language starting with the 1.4.3 release. This brings improvements to the code base and allows us to benefit from the latest features and security enhancements in Go.

Security

The following CVEs have been resolved in this release:

• CVE-2023-48795
• CVE-2023-49569
• GHSA-9763-4f94-gfch

---

1.4.2 Release Notes

Release date 07 Dec 2023

Breaking Changes

This release has no breaking changes.

Deprecations

There are no deprecations in this release.

Upgrade instructions

If you are using a 1.4.x version, we advise you to upgrade ASAP to this latest release. If you are on an older version, you should skip 1.4.0 and upgrade directly to this release.

Release Highlights

This release enhances compatibility as detailed in the changelog below.

Downloads

• Docker image v1.4.2
  • docker pull tykio/tyk-sync:v1.4.2
    

• Source code

Changelog

Updated

• Show API definitions supported up to Tyk Gateway v5.2.3

  Tyk Sync supports Tyk API definitions up to Tyk Gateway v5.2.3. Please use this version with Tyk Gateway v5.2.0+.

Further Information

Upgrading Tyk

Please refer to the upgrading Tyk page for further guidance with respect to the upgrade strategy.

FAQ

Please visit our Developer Support page for further information relating to reporting bugs, upgrading Tyk, technical support and how to contribute.

Earlier Versions Release Notes

Release Notes for Tyk Sync v1.4.1 and earlier can we found in Tyk Sync GitHub