From 79fc85832929f52e2401afe816d2e6c960f011a4 Mon Sep 17 00:00:00 2001 From: Sharad Regoti Date: Mon, 3 Nov 2025 13:57:25 +0530 Subject: [PATCH 1/2] Fixes --- ai-management/ai-studio/ai-studio-swagger.mdx | 3 +- dashboard-admin-api.mdx | 15 ++++++++- docs.json | 18 +++++++++++ .../api-documentation/tyk-edp-api.mdx | 20 ++++++++++-- tyk-dashboard-api.mdx | 32 ++++++++++++++++++- tyk-gateway-api.mdx | 26 ++++++++++++++- tyk-mdcb-api.mdx | 6 +++- 7 files changed, 113 insertions(+), 7 deletions(-) diff --git a/ai-management/ai-studio/ai-studio-swagger.mdx b/ai-management/ai-studio/ai-studio-swagger.mdx index 00bd6ff44..4a34fc1f5 100644 --- a/ai-management/ai-studio/ai-studio-swagger.mdx +++ b/ai-management/ai-studio/ai-studio-swagger.mdx @@ -2,6 +2,7 @@ title: "Tyk AI Studio API" description: "Tyk AI Studio API" keywords: "OpenAPI Spec for AI Studio, Tyk AI Studio OAS, Tyk AI Portal REST" -sidebarTitle: "API Documentation" +sidebarTitle: "Overview" --- +This is the API for the AI Studio user and group management system. \ No newline at end of file diff --git a/dashboard-admin-api.mdx b/dashboard-admin-api.mdx index 083524ff2..98d611ec6 100644 --- a/dashboard-admin-api.mdx +++ b/dashboard-admin-api.mdx @@ -1,6 +1,19 @@ --- title: "Tyk Dashboard Admin API" +description: "Tyk Dashboard Admin API documentation. This page provides details on how to use the Tyk Dashboard Admin API for setting up and provisioning a Tyk Dashboard instance." order: 4 -sidebarTitle: "Dashboard Admin" +sidebarTitle: "Overview" --- + + +For Tyk On-Premises installations only, the Dashboard Admin API has two endpoints and is used to set up and provision a Tyk Dashboard instance without the command line. + +In order to use the Dashboard Admin API, you'll need to get the `admin_secret` value from your Tyk Dashboard configurations. + +The secret you set should then be sent along as a header with each Dashboard Admin API Request in order for it to be successful: + +``` +admin-auth: +``` + diff --git a/docs.json b/docs.json index 8a14dc997..16c129b2d 100644 --- a/docs.json +++ b/docs.json @@ -393,18 +393,30 @@ "tyk-apis", { "group": "Gateway", + "pages": [ + "tyk-gateway-api" + ], "openapi": "swagger/gateway-swagger.yml" }, { "group": "Dashboard", + "pages": [ + "tyk-dashboard-api" + ], "openapi": "swagger/dashboard-swagger.yml" }, { "group": "Dashboard Admin", + "pages": [ + "dashboard-admin-api" + ], "openapi": "swagger/dashboard-admin-swagger.yml" }, { "group": "MDCB", + "pages": [ + "tyk-mdcb-api" + ], "openapi": "swagger/mdcb-swagger.yml" }, "tyk-identity-broker/tib-rest-api" @@ -539,6 +551,9 @@ "product-stack/tyk-enterprise-developer-portal/deploy/configuration", { "group": "Developer Portal API", + "pages": [ + "product-stack/tyk-enterprise-developer-portal/api-documentation/tyk-edp-api" + ], "openapi": "swagger/enterprise-developer-portal-swagger.yaml" }, "product-stack/tyk-enterprise-developer-portal/api-documentation/list-of-endpoints/portal-api-list-of-endpoints", @@ -690,6 +705,9 @@ "ai-management/ai-studio/notifications", { "group": "API Documentation", + "pages": [ + "ai-management/ai-studio/ai-studio-swagger" + ], "openapi": "swagger/ai-studio-swagger.yml" } ] diff --git a/product-stack/tyk-enterprise-developer-portal/api-documentation/tyk-edp-api.mdx b/product-stack/tyk-enterprise-developer-portal/api-documentation/tyk-edp-api.mdx index 1cead1979..1e307ebd9 100644 --- a/product-stack/tyk-enterprise-developer-portal/api-documentation/tyk-edp-api.mdx +++ b/product-stack/tyk-enterprise-developer-portal/api-documentation/tyk-edp-api.mdx @@ -1,6 +1,22 @@ --- -title: "Tyk Enterprise Developer Portal API" +title: "Tyk Developer Portal API" +description: "Tyk Developer Portal API documentation. This page provides details on how to use the Tyk Developer Portal Management API for managing portal resources." order: 3 -sidebarTitle: "Developer Portal API" +sidebarTitle: "Overview" --- + + +## Introduction + +The Tyk Developer Portal Management API offers programmatic +access to all portal resources that your instance of the portal manages. +This API repeats functionality of the user interface and enables APIs +consumers integrating their portal instances with their other IT systems +such as billings, CRMs, ITSM systems and other software. + + +## Authentication + +This API requires an admin authorisation token that is available for admin +users of the portal in the profile page. diff --git a/tyk-dashboard-api.mdx b/tyk-dashboard-api.mdx index 52e3ef24e..92543bdbc 100644 --- a/tyk-dashboard-api.mdx +++ b/tyk-dashboard-api.mdx @@ -1,6 +1,36 @@ --- title: "Tyk Dashboard API" +description: "Tyk Dashboard API documentation. This page provides details on how to use the Tyk Dashboard API for managing organisations, users, API definitions, and more." order: 3 -sidebarTitle: "Dashboard" +sidebarTitle: "Overview" --- + + +## Introduction + +The Tyk Dashboard API offers granular, programmatic access to a centralised database of resources that your Tyk nodes can pull from. This API has a dynamic user administrative structure which means the secret key that is used to communicate with your Tyk nodes can be kept secret and access to the wider management functions can be handled on a user-by-user and organisation-by-organisation basis. + +A common question around using a database-backed configuration is how to programmatically add API definitions to your Tyk nodes, the Dashboard API allows much more fine-grained, secure and multi-user access to your Tyk cluster, and should be used to manage a database-backed Tyk node. + +The Tyk Dashboard API works seamlessly with the Tyk Dashboard (and the two come bundled together). + +## Security Hierarchy + +The Dashboard API provides a more structured security layer to managing Tyk nodes. + +### Organisations, APIs and Users + +With the Dashboard API and a database-backed Tyk setup, (and to an extent with file-based API setups - if diligence is used in naming and creating definitions), the following security model is applied to the management of Upstream APIs: + +* **Organisations**: All APIs are *owned* by an organisation, this is designated by the 'OrgID' parameter in the API Definition. +* **Users**: All users created in the Dashboard belong to an organisation (unless an exception is made for super-administrative access). +* **APIs**: All APIs belong to an Organisation and only Users that belong to that organisation can see the analytics for those APIs and manage their configurations. +* **API Keys**: API Keys are designated by organisation, this means an API key that has full access rights will not be allowed to access the APIs of another organisation on the same system, but can have full access to all APIs within the organisation. +* **Access Rights**: Access rights are stored with the key, this enables a key to give access to multiple APIs, this is defined by the session object in the core Tyk API. + +In order to use the Dashboard API, you'll need to get the 'Tyk Dashboard API Access Credentials' secret from your user profile on the Dashboard UI. + +The secret you set should then be sent along as a header with each Dashboard API Request in order for it to be successful: + +`authorization: ` diff --git a/tyk-gateway-api.mdx b/tyk-gateway-api.mdx index 21116dc3a..34671c323 100644 --- a/tyk-gateway-api.mdx +++ b/tyk-gateway-api.mdx @@ -1,7 +1,31 @@ --- title: "Tyk Gateway API" +description: "Tyk Gateway API documentation. This page provides details on how to use the Tyk Gateway API for managing session objects, policies, API definitions, and more." keywords: "OpenAPI Spec, OpenAPI Specification, OAS, REST, Tyk Gateway OpenAPI Spec, Tyk Gateway OAS, API Gateway OAS, API Gateway REST" order: 3 -sidebarTitle: "Gateway" +sidebarTitle: "Overview" --- + + + +The Tyk Gateway API is the primary means for integrating your application with the Tyk API Gateway system. This API is very small, and has no granular permissions system. It is intended to be used purely for internal automation and integration. + +**Warning: Under no circumstances should outside parties be granted access to this API.** + +The Tyk Gateway API is capable of: + +* Managing session objects (key generation). +* Managing and listing policies. +* Managing and listing API Definitions (only when not using the Tyk Dashboard). +* Hot reloads / reloading a cluster configuration. +* OAuth client creation (only when not using the Tyk Dashboard). + +In order to use the Gateway API, you'll need to set the **secret** parameter in your tyk.conf file. + +The shared secret you set should then be sent along as a header with each Gateway API Request in order for it to be successful: + +`x-tyk-authorization: ` +
+ +The Tyk Gateway API is subsumed by the Tyk Dashboard API in Pro installations. diff --git a/tyk-mdcb-api.mdx b/tyk-mdcb-api.mdx index cc2723a85..ad5d0b809 100644 --- a/tyk-mdcb-api.mdx +++ b/tyk-mdcb-api.mdx @@ -1,7 +1,11 @@ --- title: "Tyk MDCB API" +description: "Tyk MDCB API documentation. This page provides details on how to use the Tyk Multi Data Center Bridge (MDCB) API for monitoring connected Data Planes and accessing diagnostic data." keywords: "OpenAPI Spec, OpenAPI Specification, OAS, REST, Tyk MDCB OpenAPI Spec, Tyk MDCB OAS, MDCB API REST" order: 3 -sidebarTitle: "Multi Data Center Bridge" +sidebarTitle: "Overview" --- +This API provides operations for monitoring Data Planes connected to MDCB and accessing diagnostic data. +It includes endpoints for retrieving connected data plane details, performing health checks, +and accessing Go's built-in pprof diagnostics for advanced performance profiling. \ No newline at end of file From f0ab1df3bf9126eea271910ec15ab757802e6eb2 Mon Sep 17 00:00:00 2001 From: Sharad Regoti Date: Wed, 26 Nov 2025 12:28:31 +0530 Subject: [PATCH 2/2] Fixes --- developer-support/release-guide.mdx | 22 ++++++++++++++++------ 1 file changed, 16 insertions(+), 6 deletions(-) diff --git a/developer-support/release-guide.mdx b/developer-support/release-guide.mdx index 90a259c3b..a8276dc13 100644 --- a/developer-support/release-guide.mdx +++ b/developer-support/release-guide.mdx @@ -132,7 +132,17 @@ Ensure the PRs for documentation, configuration, and release notes have already 1. **Create the New Release Branch** From the main branch, create a new branch named release-X.Y (e.g., release-5.10). This branch will be used to maintain the documentation for the latest version. -2. **Update the Branch Configuration** +2. **Update Redirects in docs.json** + + - In the `main` branch, edit the `docs.json` file to add all the redirects from the previous latest version. + + ```json + "redirects": [] + ``` + + - In the previous latest branch/version remove all the redirects from `docs.json` as they are no longer needed. + +3. **Update the Branch Configuration** In the main branch, edit the `branches-config.json` file. Add a new JSON object for the latest version. This configuration tells the build system how to handle the new version. * Set isLatest to true for the new release-5.10. @@ -150,7 +160,7 @@ Ensure the PRs for documentation, configuration, and release notes have already } ``` -3. **Manually Trigger the Deployment Workflow** +4. **Manually Trigger the Deployment Workflow** 1. Go to the "Actions" tab in the GitHub repository. 2. Select the "Deploy Documentation" workflow. @@ -158,11 +168,11 @@ Ensure the PRs for documentation, configuration, and release notes have already This will rebuild the `production` branch, creating the new versioned folder and updating the site's navigation to include v5.10 as the latest version. -4. **Deploy release:** +5. **Deploy release:** The PRs mentioned in the prerequisites can now be merged into `main` and the latest release branch. -7. **Update Postman Collections:**\ +6. **Update Postman Collections:**\ We maintain a Postman collection for the following Tyk Components (Gateway, Dashboard, MDCB, and Developer Portal). After a major or minor release, we need to update the Postman collections. These instructions are for a single Tyk component and must be repeated for other components. @@ -175,13 +185,13 @@ Ensure the PRs for documentation, configuration, and release notes have already 5. Add the `latest` prefix and remove the previous one. This ensures that the latest version is always displayed at the top. -8. **Update the HubSpot Banner to indicate the new release of the old docs pages.**\ +7. **~~Update~~ the HubSpot Banner to indicate the new release of the old docs pages.**\ **Description:** We use HubSpot to display a banner at the top of our docs page, which indicates that you are viewing old documentation and points to the latest version.\ **Example:** [Sample Banner](https://tyk.io/docs/4.0/getting-started/key-concepts/graphql-subscriptions/). **Steps:** Update the HubSpot banner to indicate the new release. -9. **Add a reference to release notes in Github Releases:**\ +8. **Add a reference to release notes in Github Releases:**\ **Description:** Developers usually refer to the GitHub release tags to view the changelog. These release tags should point to the release notes in the docs.\ **Example:** `https://github.com/TykTechnologies/tyk/releases/tag/v5.3.8`\ **Steps:** Modify the release tags of all components modified in a release.\