@superblocksteam/sdk-api 2.0.105-next.0 → 2.0.105-next.2

package/src/integrations/box/README.md

@@ -75,7 +75,7 @@ export default api({
     const result = await ctx.integrations.box.apiRequest(
       {
         method: "GET",
-        path: `/2.0/folders/${folderId}/items`,
+        path: `/folders/${folderId}/items`,
         params: {
           limit: limit,
           offset: 0,
@@ -133,7 +133,7 @@ const FileInfoSchema = z.object({
 const file = await ctx.integrations.box.apiRequest(
   {
     method: "GET",
-    path: `/2.0/files/${fileId}`,
+    path: `/files/${fileId}`,
     params: {
       fields:
         "id,name,size,created_at,modified_at,created_by,modified_by,parent,sha1,shared_link",
@@ -154,7 +154,7 @@ const DownloadUrlResponseSchema = z.string();
 const content = await ctx.integrations.box.apiRequest(
   {
     method: "GET",
-    path: `/2.0/files/${fileId}/content`,
+    path: `/files/${fileId}/content`,
   },
   { response: DownloadUrlResponseSchema },
 );
@@ -172,7 +172,7 @@ const UploadResponseSchema = z.object({
 const result = await ctx.integrations.box.apiRequest(
   {
     method: "POST",
-    path: "/2.0/files/content",
+    path: "/files/content",
     headers: {
       "Content-Type": "multipart/form-data",
     },
@@ -209,7 +209,7 @@ const FolderInfoSchema = z.object({
 const folder = await ctx.integrations.box.apiRequest(
   {
     method: "POST",
-    path: "/2.0/folders",
+    path: "/folders",
     body: {
       name: "New Folder",
       parent: {
@@ -229,7 +229,7 @@ console.log(`Created folder: ${folder.name} (${folder.id})`);
 const copiedFile = await ctx.integrations.box.apiRequest(
   {
     method: "POST",
-    path: `/2.0/files/${fileId}/copy`,
+    path: `/files/${fileId}/copy`,
     body: {
       parent: {
         id: destinationFolderId,
@@ -247,7 +247,7 @@ const copiedFile = await ctx.integrations.box.apiRequest(
 const movedFile = await ctx.integrations.box.apiRequest(
   {
     method: "PUT",
-    path: `/2.0/files/${fileId}`,
+    path: `/files/${fileId}`,
     body: {
       parent: {
         id: newParentFolderId,
@@ -264,7 +264,7 @@ const movedFile = await ctx.integrations.box.apiRequest(
 const updatedFile = await ctx.integrations.box.apiRequest(
   {
     method: "PUT",
-    path: `/2.0/files/${fileId}`,
+    path: `/files/${fileId}`,
     body: {
       name: "renamed-file.txt",
       description: "Updated file description",
@@ -281,7 +281,7 @@ const updatedFile = await ctx.integrations.box.apiRequest(
 await ctx.integrations.box.apiRequest(
   {
     method: "DELETE",
-    path: `/2.0/files/${fileId}`,
+    path: `/files/${fileId}`,
   },
   { response: z.void() },
 );
@@ -304,7 +304,7 @@ const SharedLinkSchema = z.object({
 const file = await ctx.integrations.box.apiRequest(
   {
     method: "PUT",
-    path: `/2.0/files/${fileId}`,
+    path: `/files/${fileId}`,
     params: {
       fields: "shared_link",
     },
@@ -337,7 +337,7 @@ const SearchResponseSchema = z.object({
 const result = await ctx.integrations.box.apiRequest(
   {
     method: "GET",
-    path: "/2.0/search",
+    path: "/search",
     params: {
       query: "quarterly report",
       type: "file",
@@ -372,7 +372,7 @@ const CommentSchema = z.object({
 const comment = await ctx.integrations.box.apiRequest(
   {
     method: "POST",
-    path: "/2.0/comments",
+    path: "/comments",
     body: {
       item: {
         type: "file",
@@ -400,22 +400,22 @@ await box.uploadFile({ ... });
 
 // CORRECT - Use apiRequest
 await ctx.integrations.box.apiRequest(
-  { method: "GET", path: `/2.0/folders/${folderId}/items`, params: { ... } },
+  { method: "GET", path: `/folders/${folderId}/items`, params: { ... } },
   { response: ListItemsResponseSchema }
 );
 ```
 
 ### API Version in Path
 
-Box API paths include version:
+The base URL already includes `/2.0`, so do not repeat it in paths:
 
 ```typescript
-// CORRECT - Include version
-const path = "/2.0/files/123";
-const path = "/2.0/folders/0/items";
-
-// WRONG - Missing version
+// CORRECT - No version prefix (base URL already has /2.0)
 const path = "/files/123";
+const path = "/folders/0/items";
+
+// WRONG - Duplicates version from base URL
+const path = "/2.0/files/123";
 ```
 
 ### Root Folder ID is "0"
@@ -437,7 +437,7 @@ Use `fields` to get specific data:
 ```typescript
 // Without fields, you get minimal data
 const result = await ctx.integrations.box.apiRequest(
-  { method: "GET", path: `/2.0/files/${fileId}` },
+  { method: "GET", path: `/files/${fileId}` },
   { response: FileSchema },
 );
 
@@ -445,7 +445,7 @@ const result = await ctx.integrations.box.apiRequest(
 const result = await ctx.integrations.box.apiRequest(
   {
     method: "GET",
-    path: `/2.0/files/${fileId}`,
+    path: `/files/${fileId}`,
     params: {
       fields: "id,name,size,created_at,modified_at,parent,shared_link",
     },
@@ -477,7 +477,7 @@ Use `If-Match` with etag for safe updates:
 const result = await ctx.integrations.box.apiRequest(
   {
     method: "PUT",
-    path: `/2.0/files/${fileId}`,
+    path: `/files/${fileId}`,
     headers: {
       "If-Match": file.etag, // Prevents overwriting concurrent changes
     },
@@ -503,7 +503,7 @@ async function getAllItems(box: BoxClient, folderId: string) {
     const result = await ctx.integrations.box.apiRequest(
       {
         method: "GET",
-        path: `/2.0/folders/${folderId}/items`,
+        path: `/folders/${folderId}/items`,
         params: { limit, offset, fields: "id,name,type" },
       },
       { response: ListItemsResponseSchema },
@@ -557,7 +557,7 @@ import { RestApiValidationError } from "@superblocksteam/sdk-api";
 
 try {
   const result = await ctx.integrations.box.apiRequest(
-    { method: "GET", path: `/2.0/folders/${folderId}/items`, params: { ... } },
+    { method: "GET", path: `/folders/${folderId}/items`, params: { ... } },
     { response: ListItemsResponseSchema }
   );
 } catch (error) {

package/src/integrations/box/types.ts

@@ -24,7 +24,7 @@ import type { SupportsApiRequest } from "../base/index.js";
  * const result = await box.apiRequest(
  *   {
  *     method: 'GET',
- *     path: '/2.0/folders/0',
+ *     path: '/folders/0',
  *   },
  *   { response: ResponseSchema }
  * );

package/src/integrations/circleci/README.md

@@ -51,7 +51,7 @@ export default api({
     const result = await ctx.integrations.circleci.apiRequest(
       {
         method: "POST",
-        path: `/api/v2/project/${projectSlug}/pipeline`,
+        path: `/project/${projectSlug}/pipeline`,
         body: {
           branch: branch,
           parameters: {
@@ -73,7 +73,7 @@ export default api({
 const result = await ctx.integrations.circleci.apiRequest(
   {
     method: "GET",
-    path: `/api/v2/pipeline/${pipelineId}`,
+    path: `/pipeline/${pipelineId}`,
   },
   { response: PipelineSchema },
 );
@@ -102,7 +102,7 @@ const ListWorkflowsResponseSchema = z.object({
 const result = await ctx.integrations.circleci.apiRequest(
   {
     method: "GET",
-    path: `/api/v2/pipeline/${pipelineId}/workflow`,
+    path: `/pipeline/${pipelineId}/workflow`,
   },
   { response: ListWorkflowsResponseSchema },
 );
@@ -133,7 +133,7 @@ const ListJobsResponseSchema = z.object({
 const result = await ctx.integrations.circleci.apiRequest(
   {
     method: "GET",
-    path: `/api/v2/workflow/${workflowId}/job`,
+    path: `/workflow/${workflowId}/job`,
   },
   { response: ListJobsResponseSchema },
 );
@@ -162,7 +162,7 @@ const JobDetailSchema = z.object({
 const result = await ctx.integrations.circleci.apiRequest(
   {
     method: "GET",
-    path: `/api/v2/project/${projectSlug}/job/${jobNumber}`,
+    path: `/project/${projectSlug}/job/${jobNumber}`,
   },
   { response: JobDetailSchema },
 );
@@ -178,7 +178,7 @@ const RetryResponseSchema = z.object({
 const result = await ctx.integrations.circleci.apiRequest(
   {
     method: "POST",
-    path: `/api/v2/workflow/${workflowId}/rerun`,
+    path: `/workflow/${workflowId}/rerun`,
     body: {
       from_failed: true, // Only rerun failed jobs
     },
@@ -199,7 +199,7 @@ const CancelResponseSchema = z.object({
 const result = await ctx.integrations.circleci.apiRequest(
   {
     method: "POST",
-    path: `/api/v2/workflow/${workflowId}/cancel`,
+    path: `/workflow/${workflowId}/cancel`,
   },
   { response: CancelResponseSchema },
 );
@@ -216,7 +216,7 @@ const ListPipelinesResponseSchema = z.object({
 const result = await ctx.integrations.circleci.apiRequest(
   {
     method: "GET",
-    path: `/api/v2/project/${projectSlug}/pipeline`,
+    path: `/project/${projectSlug}/pipeline`,
     params: {
       branch: "main",
       "page-token": undefined, // For pagination
@@ -247,7 +247,7 @@ const ProjectSchema = z.object({
 const result = await ctx.integrations.circleci.apiRequest(
   {
     method: "GET",
-    path: `/api/v2/project/${projectSlug}`,
+    path: `/project/${projectSlug}`,
   },
   { response: ProjectSchema },
 );
@@ -270,7 +270,7 @@ const ListArtifactsResponseSchema = z.object({
 const result = await ctx.integrations.circleci.apiRequest(
   {
     method: "GET",
-    path: `/api/v2/project/${projectSlug}/${jobNumber}/artifacts`,
+    path: `/project/${projectSlug}/${jobNumber}/artifacts`,
   },
   { response: ListArtifactsResponseSchema },
 );
@@ -295,7 +295,7 @@ await circleci.getWorkflow({ ... });
 
 // CORRECT - Use apiRequest
 await ctx.integrations.circleci.apiRequest(
-  { method: "POST", path: `/api/v2/project/${slug}/pipeline`, body: { ... } },
+  { method: "POST", path: `/project/${slug}/pipeline`, body: { ... } },
   { response: PipelineSchema }
 );
 ```
@@ -317,13 +317,13 @@ const slug = "gl/my-group/my-repo";
 
 ### API Version in Path
 
-Always include `/api/v2/`:
+The base URL already includes `/api/v2`, so do not repeat it in paths:
 
 ```typescript
-// WRONG
+// CORRECT - No version prefix (base URL already has /api/v2)
 const path = `/project/${slug}/pipeline`;
 
-// CORRECT
+// WRONG - Duplicates version from base URL
 const path = `/api/v2/project/${slug}/pipeline`;
 ```
 
@@ -406,7 +406,7 @@ async function getAllPipelines(circleci: CircleCIClient, projectSlug: string) {
     const result = await ctx.integrations.circleci.apiRequest(
       {
         method: "GET",
-        path: `/api/v2/project/${projectSlug}/pipeline`,
+        path: `/project/${projectSlug}/pipeline`,
         params: pageToken ? { "page-token": pageToken } : {},
       },
       { response: ListPipelinesResponseSchema },
@@ -429,7 +429,7 @@ When rerunning workflows:
 await ctx.integrations.circleci.apiRequest(
   {
     method: "POST",
-    path: `/api/v2/workflow/${workflowId}/rerun`,
+    path: `/workflow/${workflowId}/rerun`,
     body: {
       from_failed: false, // Rerun everything
     },
@@ -441,7 +441,7 @@ await ctx.integrations.circleci.apiRequest(
 await ctx.integrations.circleci.apiRequest(
   {
     method: "POST",
-    path: `/api/v2/workflow/${workflowId}/rerun`,
+    path: `/workflow/${workflowId}/rerun`,
     body: {
       from_failed: true, // Only failed jobs
     },
@@ -457,7 +457,7 @@ import { RestApiValidationError } from "@superblocksteam/sdk-api";
 
 try {
   const result = await ctx.integrations.circleci.apiRequest(
-    { method: "POST", path: `/api/v2/project/${slug}/pipeline`, body: { ... } },
+    { method: "POST", path: `/project/${slug}/pipeline`, body: { ... } },
     { response: PipelineSchema }
   );
 } catch (error) {

package/src/integrations/declarations.ts

@@ -24,7 +24,7 @@
  *   output: z.object({ name: z.string() }),
  *   async run(ctx) {
  *     const users = await ctx.integrations.pg.query(...);
- *     await ctx.integrations.notifier.postMessage(...);
+ *     await ctx.integrations.notifier.apiRequest(...);
  *     return { name: users[0].name };
  *   },
  * });
@@ -43,7 +43,6 @@ import type { CockroachDBClient } from "./cockroachdb/index.js";
 import type { CohereClient } from "./cohere/index.js";
 import type { ConfluenceClient } from "./confluence/index.js";
 import type { CosmosDBClient } from "./cosmosdb/index.js";
-import type { CouchbaseClient } from "./couchbase/index.js";
 import type { DatabricksClient } from "./databricks/index.js";
 import type { DatadogClient } from "./datadog/index.js";
 import type { DropboxClient } from "./dropbox/index.js";
@@ -62,8 +61,6 @@ import type { GoogleSheetsClient } from "./gsheets/index.js";
 import type { HubSpotClient } from "./hubspot/index.js";
 import type { IntercomClient } from "./intercom/index.js";
 import type { JiraClient } from "./jira/index.js";
-import type { KafkaClient } from "./kafka/index.js";
-import type { KinesisClient } from "./kinesis/index.js";
 import type { LakebaseClient } from "./lakebase/index.js";
 import type { LaunchDarklyClient } from "./launchdarkly/index.js";
 import type { MariaDBClient } from "./mariadb/index.js";
@@ -77,7 +74,6 @@ import type { OracleDBClient } from "./oracledb/index.js";
 import type { PagerDutyClient } from "./pagerduty/index.js";
 import type { PerplexityClient } from "./perplexity/index.js";
 import type { PostgresClient } from "./postgres/index.js";
-import type { PythonClient } from "./python/index.js";
 import type { RedisClient } from "./redis/index.js";
 import type { RedshiftClient } from "./redshift/index.js";
 import type { RestApiIntegrationPluginClient } from "./restapiintegration/index.js";
@@ -313,9 +309,6 @@ export type DynamoDBRef = IntegrationRef<"dynamodb", DynamoDBClient>;
 /** Reference to a CosmosDB integration */
 export type CosmosDBRef = IntegrationRef<"cosmosdb", CosmosDBClient>;
 
-/** Reference to a Couchbase integration */
-export type CouchbaseRef = IntegrationRef<"couchbase", CouchbaseClient>;
-
 /** Reference to an S3 integration */
 export type S3Ref = IntegrationRef<"s3", S3Client>;
 
@@ -325,12 +318,6 @@ export type GCSRef = IntegrationRef<"gcs", GCSClient>;
 /** Reference to a Google Sheets integration */
 export type GoogleSheetsRef = IntegrationRef<"gsheets", GoogleSheetsClient>;
 
-/** Reference to a Kafka integration */
-export type KafkaRef = IntegrationRef<"kafka", KafkaClient>;
-
-/** Reference to a Kinesis integration */
-export type KinesisRef = IntegrationRef<"kinesis", KinesisClient>;
-
 /** Reference to a Salesforce integration */
 export type SalesforceRef = IntegrationRef<"salesforce", SalesforceClient>;
 
@@ -343,15 +330,6 @@ export type SuperblocksOCRRef = IntegrationRef<
   SuperblocksOCRClient
 >;
 
-/** Reference to a Python integration */
-export type PythonRef = IntegrationRef<"python", PythonClient>;
-
-/** Reference to a Confluent integration (Kafka-compatible) */
-export type ConfluentRef = IntegrationRef<"confluent", KafkaClient>;
-
-/** Reference to a Redpanda integration (Kafka-compatible) */
-export type RedpandaRef = IntegrationRef<"redpanda", KafkaClient>;
-
 /** Reference to a Lakebase integration */
 export type LakebaseRef = IntegrationRef<"lakebase", LakebaseClient>;
 
@@ -426,10 +404,10 @@ export function postgres<T extends string>(id: LiteralString<T>): PostgresRef {
  *   input: z.object({ message: z.string() }),
  *   output: z.object({ sent: z.boolean() }),
  *   async run(ctx, { message }) {
- *     await ctx.integrations.notifier.postMessage({
- *       channel: '#alerts',
- *       text: message,
- *     });
+ *     await ctx.integrations.notifier.apiRequest(
+ *       { method: 'POST', path: '/chat.postMessage', body: { channel: '#alerts', text: message } },
+ *       { response: z.object({ ok: z.boolean() }) }
+ *     );
  *     return { sent: true };
  *   },
  * });
@@ -971,18 +949,6 @@ export function cosmosdb<T extends string>(id: LiteralString<T>): CosmosDBRef {
   return createRef<"cosmosdb", CosmosDBClient, T>("cosmosdb", id);
 }
 
-/**
- * Declare a Couchbase integration.
- *
- * @param id - The integration ID (UUID)
- * @returns An integration reference for use in the API config
- */
-export function couchbase<T extends string>(
-  id: LiteralString<T>,
-): CouchbaseRef {
-  return createRef<"couchbase", CouchbaseClient, T>("couchbase", id);
-}
-
 /**
  * Declare an S3 integration.
  *
@@ -1015,26 +981,6 @@ export function googleSheets<T extends string>(
   return createRef<"gsheets", GoogleSheetsClient, T>("gsheets", id);
 }
 
-/**
- * Declare a Kafka integration.
- *
- * @param id - The integration ID (UUID)
- * @returns An integration reference for use in the API config
- */
-export function kafka<T extends string>(id: LiteralString<T>): KafkaRef {
-  return createRef<"kafka", KafkaClient, T>("kafka", id);
-}
-
-/**
- * Declare a Kinesis integration.
- *
- * @param id - The integration ID (UUID)
- * @returns An integration reference for use in the API config
- */
-export function kinesis<T extends string>(id: LiteralString<T>): KinesisRef {
-  return createRef<"kinesis", KinesisClient, T>("kinesis", id);
-}
-
 /**
  * Declare a Salesforce integration.
  *
@@ -1072,38 +1018,6 @@ export function superblocksOcr<T extends string>(
   );
 }
 
-/**
- * Declare a Python integration.
- *
- * @param id - The integration ID (UUID)
- * @returns An integration reference for use in the API config
- */
-export function python<T extends string>(id: LiteralString<T>): PythonRef {
-  return createRef<"python", PythonClient, T>("python", id);
-}
-
-/**
- * Declare a Confluent integration (Kafka-compatible).
- *
- * @param id - The integration ID (UUID)
- * @returns An integration reference for use in the API config
- */
-export function confluent<T extends string>(
-  id: LiteralString<T>,
-): ConfluentRef {
-  return createRef<"confluent", KafkaClient, T>("confluent", id);
-}
-
-/**
- * Declare a Redpanda integration (Kafka-compatible).
- *
- * @param id - The integration ID (UUID)
- * @returns An integration reference for use in the API config
- */
-export function redpanda<T extends string>(id: LiteralString<T>): RedpandaRef {
-  return createRef<"redpanda", KafkaClient, T>("redpanda", id);
-}
-
 /**
  * Declare a Lakebase integration.
  *

package/src/integrations/documentation.test.ts

@@ -15,9 +15,7 @@ type PlaceholderDocsCase = {
 };
 
 const DOC_DIRECTORY_ALIASES = {
-  confluent: "kafka",
   graphqlintegration: "graphql",
-  redpanda: "kafka",
 } as const;
 
 const DOC_DIRECTORY_EXCLUSIONS = new Set(["base"]);

package/src/integrations/googledrive/README.md

@@ -71,7 +71,7 @@ export default api({
     const result = await ctx.integrations.drive.apiRequest(
       {
         method: "GET",
-        path: "/drive/v3/files",
+        path: "/files",
         params: {
           q: query,
           pageSize: pageSize,
@@ -99,7 +99,7 @@ export default api({
 const file = await ctx.integrations.drive.apiRequest(
   {
     method: "GET",
-    path: `/drive/v3/files/${fileId}`,
+    path: `/files/${fileId}`,
     params: {
       fields:
         "id,name,mimeType,size,createdTime,modifiedTime,parents,webViewLink,webContentLink,owners",
@@ -120,7 +120,7 @@ const DownloadResponseSchema = z.string(); // Raw content
 const content = await ctx.integrations.drive.apiRequest(
   {
     method: "GET",
-    path: `/drive/v3/files/${fileId}`,
+    path: `/files/${fileId}`,
     params: {
       alt: "media",
     },
@@ -134,7 +134,7 @@ const ExportResponseSchema = z.string();
 const docContent = await ctx.integrations.drive.apiRequest(
   {
     method: "GET",
-    path: `/drive/v3/files/${fileId}/export`,
+    path: `/files/${fileId}/export`,
     params: {
       mimeType: "text/plain", // or application/pdf, text/html, etc.
     },
@@ -149,7 +149,7 @@ const docContent = await ctx.integrations.drive.apiRequest(
 const folder = await ctx.integrations.drive.apiRequest(
   {
     method: "POST",
-    path: "/drive/v3/files",
+    path: "/files",
     body: {
       name: "New Folder",
       mimeType: "application/vnd.google-apps.folder",
@@ -194,7 +194,7 @@ const uploadedFile = await ctx.integrations.drive.apiRequest(
 const updatedFile = await ctx.integrations.drive.apiRequest(
   {
     method: "PATCH",
-    path: `/drive/v3/files/${fileId}`,
+    path: `/files/${fileId}`,
     body: {
       name: "Renamed File.txt",
       description: "Updated description",
@@ -210,7 +210,7 @@ const updatedFile = await ctx.integrations.drive.apiRequest(
 const movedFile = await ctx.integrations.drive.apiRequest(
   {
     method: "PATCH",
-    path: `/drive/v3/files/${fileId}`,
+    path: `/files/${fileId}`,
     params: {
       addParents: newFolderId,
       removeParents: oldFolderId,
@@ -226,7 +226,7 @@ const movedFile = await ctx.integrations.drive.apiRequest(
 const result = await ctx.integrations.drive.apiRequest(
   {
     method: "GET",
-    path: "/drive/v3/files",
+    path: "/files",
     params: {
       q: "name contains 'report' and mimeType = 'application/pdf' and trashed = false",
       pageSize: 25,
@@ -250,7 +250,7 @@ const PermissionSchema = z.object({
 const permission = await ctx.integrations.drive.apiRequest(
   {
     method: "POST",
-    path: `/drive/v3/files/${fileId}/permissions`,
+    path: `/files/${fileId}/permissions`,
     body: {
       type: "user", // user, group, domain, anyone
       role: "reader", // reader, writer, commenter, owner
@@ -271,7 +271,7 @@ const permission = await ctx.integrations.drive.apiRequest(
 await ctx.integrations.drive.apiRequest(
   {
     method: "PATCH",
-    path: `/drive/v3/files/${fileId}`,
+    path: `/files/${fileId}`,
     body: {
       trashed: true,
     },
@@ -283,7 +283,7 @@ await ctx.integrations.drive.apiRequest(
 await ctx.integrations.drive.apiRequest(
   {
     method: "DELETE",
-    path: `/drive/v3/files/${fileId}`,
+    path: `/files/${fileId}`,
   },
   { response: z.void() },
 );
@@ -304,7 +304,7 @@ await drive.uploadFile({ ... });
 
 // CORRECT - Use apiRequest
 await ctx.integrations.drive.apiRequest(
-  { method: "GET", path: "/drive/v3/files", params: { ... } },
+  { method: "GET", path: "/files", params: { ... } },
   { response: ListFilesResponseSchema }
 );
 ```
@@ -316,7 +316,7 @@ By default, only basic fields are returned. Use the `fields` parameter:
 ```typescript
 // WRONG - Missing fields, gets minimal data
 const file = await ctx.integrations.drive.apiRequest(
-  { method: "GET", path: `/drive/v3/files/${fileId}` },
+  { method: "GET", path: `/files/${fileId}` },
   { response: FileSchema },
 );
 // file.size, file.owners, etc. will be undefined
@@ -325,7 +325,7 @@ const file = await ctx.integrations.drive.apiRequest(
 const file = await ctx.integrations.drive.apiRequest(
   {
     method: "GET",
-    path: `/drive/v3/files/${fileId}`,
+    path: `/files/${fileId}`,
     params: {
       fields: "id,name,mimeType,size,createdTime,modifiedTime,owners",
     },
@@ -367,10 +367,10 @@ Google Docs, Sheets, etc. must be exported, not downloaded directly:
 
 ```typescript
 // Regular files - use alt=media
-const path = `/drive/v3/files/${fileId}?alt=media`;
+const path = `/files/${fileId}?alt=media`;
 
 // Google Docs - use export endpoint
-const path = `/drive/v3/files/${fileId}/export?mimeType=text/plain`;
+const path = `/files/${fileId}/export?mimeType=text/plain`;
 
 // Export formats for Google Docs
 // Documents: text/plain, text/html, application/pdf, application/vnd.oasis.opendocument.text
@@ -396,14 +396,17 @@ const sizeMB = sizeBytes / (1024 * 1024);
 
 ### Upload Path vs Regular Path
 
-File uploads use a different base path:
+The base URL already includes `/drive/v3`, so regular API paths omit this prefix. However, uploads use a different URL root (`/upload/drive/v3/...` instead of `/drive/v3/...`) and require the full path:
 
 ```typescript
-// Regular API calls
-const path = "/drive/v3/files";
+// Regular API calls (base URL already has /drive/v3)
+const path = "/files";
 
-// Upload calls
+// Upload calls use a different URL root — include the full path
 const path = "/upload/drive/v3/files";
+
+// WRONG - Duplicates base URL prefix for regular calls
+const path = "/drive/v3/files";
 ```
 
 ### Folder MIME Type
@@ -436,7 +439,7 @@ async function getAllFiles(drive: GoogleDriveClient, folderId: string) {
     const result = await ctx.integrations.drive.apiRequest(
       {
         method: "GET",
-        path: "/drive/v3/files",
+        path: "/files",
         params: {
           q: `'${folderId}' in parents and trashed = false`,
           pageSize: 100,
@@ -463,7 +466,7 @@ import { RestApiValidationError } from "@superblocksteam/sdk-api";
 
 try {
   const result = await ctx.integrations.drive.apiRequest(
-    { method: "GET", path: "/drive/v3/files", params: { ... } },
+    { method: "GET", path: "/files", params: { ... } },
     { response: ListFilesResponseSchema }
   );
 } catch (error) {