From 6455de21a45f5ab4663e4d2d96f76365f92d7a4f Mon Sep 17 00:00:00 2001
From: "tembo[bot]" <208362400+tembo[bot]@users.noreply.github.com>
Date: Fri, 7 Aug 2026 00:08:18 +0000
Subject: [PATCH] docs(api): use public API endpoint prefix
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Vinícius <36349314+vrmiguel@users.noreply.github.com>
---
 api/index.mdx              |  2 +-
 integrations/snowflake.mdx |  6 +++---
 openapi.documented.yml     | 10 +++++-----
 openapi.self-hosted.yml    |  2 +-
 4 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/api/index.mdx b/api/index.mdx
index a4b7b0a..c74f176 100644
--- a/api/index.mdx
+++ b/api/index.mdx
@@ -13,7 +13,7 @@ Generate an API key from **Settings > API Keys** in the [dashboard](https://app.
 
 ```bash
 curl -H "Authorization: Bearer YOUR_API_KEY" \
-  https://api.tembo.io/session/list
+  https://api.tembo.io/public-api/session/list
 ```
 
 ## SDK
diff --git a/integrations/snowflake.mdx b/integrations/snowflake.mdx
index a02888e..bc95660 100644
--- a/integrations/snowflake.mdx
+++ b/integrations/snowflake.mdx
@@ -36,7 +36,7 @@ The integration is implemented as a Snowflake-managed MCP server that exposes Te
   - `CREATE AGENT` on the target schema
   - `USAGE` on a warehouse the agent will run with
 - A Tembo API token — generate one from your Tembo account settings
-- The Tembo REST API base URL: `https://api.tembo.io`
+- The Tembo REST API base URL: `https://api.tembo.io/public-api`
 
 For self-hosted Tembo installs, substitute your deployment's base URL throughout. See [Self-Hosted Overview](/features/self-hosted/overview) for details.
 
@@ -96,7 +96,7 @@ PACKAGES = ('requests')
 AS $$
 import _snowflake, json, requests
 
-BASE = "https://api.tembo.io"
+BASE = "https://api.tembo.io/public-api"
 
 ROUTES = {
     "list_sessions":      ("GET",  "/session/list"),
@@ -333,7 +333,7 @@ SHOW EXTERNAL ACCESS INTEGRATIONS LIKE 'tembo_api_access_integration';
   </Accordion>
 
   <Accordion title="Self-hosted Tembo">
-    For self-hosted Tembo, replace `https://api.tembo.io` with your deployment's base URL in both the network rule (`VALUE_LIST`) and the Python UDF (`BASE`). The rest of the flow is identical.
+    For self-hosted Tembo, replace `https://api.tembo.io/public-api` with your deployment's public API base URL (for example, `https://tembo.example.com/api/public-api`) in the Python UDF (`BASE`). Update the network rule (`VALUE_LIST`) to allow your deployment's host. The rest of the flow is identical.
   </Accordion>
 
   <Accordion title="Rotating the API token">
diff --git a/openapi.documented.yml b/openapi.documented.yml
index 0d6f608..b19a4f6 100644
--- a/openapi.documented.yml
+++ b/openapi.documented.yml
@@ -4,7 +4,7 @@ info:
     description: Tembo Developer API
     version: 1.0.0
 servers:
-    - url: https://api.tembo.io/
+    - url: https://api.tembo.io/public-api/
       description: Tembo API
 components:
     securitySchemes:
@@ -552,7 +552,7 @@ paths:
                   label: cURL
                   source: |-
                       curl -s -X POST \
-                        "https://api.tembo.io/session/${SESSION_ID}/messages" \
+                        "https://api.tembo.io/public-api/session/${SESSION_ID}/messages" \
                         -H "Authorization: Bearer ${API_KEY}" \
                         -H "Content-Type: application/json" \
                         -d '{"content": "Please add a regression test for this change."}'
@@ -702,7 +702,7 @@ paths:
                 - lang: bash
                   source: |-
                       curl -s -X POST \
-                        "https://api.tembo.io/agent" \
+                        "https://api.tembo.io/public-api/agent" \
                         -H "Authorization: Bearer ${API_KEY}" \
                         -H "Content-Type: application/json" \
                         -d '{
@@ -812,7 +812,7 @@ paths:
                   label: Bearer Auth
                   source: |-
                       curl -s -X POST \
-                        "https://api.tembo.io/agent/${AGENT_ID}/trigger" \
+                        "https://api.tembo.io/public-api/agent/${AGENT_ID}/trigger" \
                         -H "Authorization: Bearer ${API_KEY}" \
                         -H "Content-Type: application/json" \
                         -d '{"issue_url": "https://github.com/org/repo/issues/42"}' | jq .
@@ -820,7 +820,7 @@ paths:
                   label: Query Param Auth
                   source: |-
                       curl -s -X POST \
-                        "https://api.tembo.io/agent/${AGENT_ID}/trigger?apiKey=${API_KEY}" \
+                        "https://api.tembo.io/public-api/agent/${AGENT_ID}/trigger?apiKey=${API_KEY}" \
                         -H "Content-Type: application/json" \
                         -d '{"issue_url": "https://github.com/org/repo/issues/42"}' | jq .
     /repository/list:
diff --git a/openapi.self-hosted.yml b/openapi.self-hosted.yml
index 8e4cf18..bc5d05d 100644
--- a/openapi.self-hosted.yml
+++ b/openapi.self-hosted.yml
@@ -552,7 +552,7 @@ paths:
                   label: cURL
                   source: |-
                       curl -s -X POST \
-                        "https://api.tembo.io/session/${SESSION_ID}/messages" \
+                        "https://tembo.example.com/api/public-api/session/${SESSION_ID}/messages" \
                         -H "Authorization: Bearer ${API_KEY}" \
                         -H "Content-Type: application/json" \
                         -d '{"content": "Please add a regression test for this change."}'