From 79fc85832929f52e2401afe816d2e6c960f011a4 Mon Sep 17 00:00:00 2001 From: Sharad Regoti Date: Mon, 3 Nov 2025 13:57:25 +0530 Subject: [PATCH 1/3] 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 ea372e2576ed47d6db531f1c2f42b02fc2bb27b2 Mon Sep 17 00:00:00 2001 From: Sharad Regoti Date: Fri, 21 Nov 2025 10:57:41 +0530 Subject: [PATCH 2/3] Fixed default values --- .gitignore | 12 ++++++++++++ product-stack/tyk-charts/tyk-stack-chart.mdx | 2 +- 2 files changed, 13 insertions(+), 1 deletion(-) diff --git a/.gitignore b/.gitignore index bcd218f54..14cce41af 100644 --- a/.gitignore +++ b/.gitignore @@ -1,3 +1,15 @@ +.DS_Store +backup_unused/ +backup_unused_main/ +cleanup-unused-images.sh +index.js +mintlify-fix-redirect/ +not-found.txt +transform.sh +unused_images_log.txt +urls.txt +flatten_alpha_log* + ### Node template # Logs logs diff --git a/product-stack/tyk-charts/tyk-stack-chart.mdx b/product-stack/tyk-charts/tyk-stack-chart.mdx index dd71930d3..e2f2e96a1 100644 --- a/product-stack/tyk-charts/tyk-stack-chart.mdx +++ b/product-stack/tyk-charts/tyk-stack-chart.mdx @@ -21,7 +21,7 @@ By default, this chart installs the following components as sub-charts on a [Kub | :--------------------------------- | :-------------------- | :----------------------------- | | Tyk Gateway | true | n/a | | Tyk Dashboard | true | n/a | -| Tyk Pump | false | global.components.pump | +| Tyk Pump | true | global.components.pump | | Tyk Enterprise Developer Portal | false | global.components.devPortal | | Tyk Operator | false | global.components.operator | From 8f0a912958cbed671f8a3e7ea47cb09fa5d1cde0 Mon Sep 17 00:00:00 2001 From: Sharad Regoti Date: Fri, 21 Nov 2025 10:58:04 +0530 Subject: [PATCH 3/3] Fixed default values --- .gitignore | 12 ------------ 1 file changed, 12 deletions(-) diff --git a/.gitignore b/.gitignore index 14cce41af..bcd218f54 100644 --- a/.gitignore +++ b/.gitignore @@ -1,15 +1,3 @@ -.DS_Store -backup_unused/ -backup_unused_main/ -cleanup-unused-images.sh -index.js -mintlify-fix-redirect/ -not-found.txt -transform.sh -unused_images_log.txt -urls.txt -flatten_alpha_log* - ### Node template # Logs logs