diff --git a/packages/core/postgrest-js/src/PostgrestBuilder.ts b/packages/core/postgrest-js/src/PostgrestBuilder.ts
index 3547fd409..0fa658ca1 100644
--- a/packages/core/postgrest-js/src/PostgrestBuilder.ts
+++ b/packages/core/postgrest-js/src/PostgrestBuilder.ts
@@ -28,7 +28,8 @@ export default abstract class PostgrestBuilder<
   protected fetch: Fetch
   protected isMaybeSingle: boolean
 
-  /**
+  /** @hidden
+   *
    * Creates a builder configured for a specific PostgREST request.
    *
    * @example
diff --git a/packages/core/postgrest-js/src/PostgrestClient.ts b/packages/core/postgrest-js/src/PostgrestClient.ts
index dbc11bc60..f39779f2b 100644
--- a/packages/core/postgrest-js/src/PostgrestClient.ts
+++ b/packages/core/postgrest-js/src/PostgrestClient.ts
@@ -3,7 +3,8 @@ import PostgrestFilterBuilder from './PostgrestFilterBuilder'
 import { Fetch, GenericSchema, ClientServerOptions } from './types/common/common'
 import { GetRpcFunctionFilterBuilderByArgs } from './types/common/rpc'
 
-/**
+/** @hidden
+ *
  * PostgREST client.
  *
  * @typeParam Database - Types for the schema from the [type
diff --git a/packages/core/postgrest-js/src/PostgrestError.ts b/packages/core/postgrest-js/src/PostgrestError.ts
index 151f9943b..d1d86f592 100644
--- a/packages/core/postgrest-js/src/PostgrestError.ts
+++ b/packages/core/postgrest-js/src/PostgrestError.ts
@@ -8,7 +8,8 @@ export default class PostgrestError extends Error {
   hint: string
   code: string
 
-  /**
+  /** @hidden
+   *
    * @example
    * ```ts
    * import PostgrestError from '@supabase/postgrest-js'
diff --git a/packages/core/postgrest-js/src/PostgrestQueryBuilder.ts b/packages/core/postgrest-js/src/PostgrestQueryBuilder.ts
index 25bb604b4..df53f727e 100644
--- a/packages/core/postgrest-js/src/PostgrestQueryBuilder.ts
+++ b/packages/core/postgrest-js/src/PostgrestQueryBuilder.ts
@@ -21,7 +21,8 @@ export default class PostgrestQueryBuilder<
   signal?: AbortSignal
   fetch?: Fetch
 
-  /**
+  /** @hidden
+   *
    * Creates a query builder scoped to a Postgres table or view.
    *
    * @example
@@ -265,7 +266,7 @@ export default class PostgrestQueryBuilder<
     Relationships,
     'POST'
   >
-    /**
+  /**
    * Perform an UPSERT on the table or view. Depending on the column(s) passed
    * to `onConflict`, `.upsert()` allows you to perform the equivalent of
    * `.insert()` if a row with the corresponding `onConflict` columns doesn't
@@ -351,7 +352,6 @@ export default class PostgrestQueryBuilder<
    * ```
    */
 
-
   upsert<Row extends Relation extends { Insert: unknown } ? Relation['Insert'] : never>(
     values: Row | Row[],
     {
diff --git a/packages/core/postgrest-js/src/index.ts b/packages/core/postgrest-js/src/index.ts
index 83772cd56..16d90372a 100644
--- a/packages/core/postgrest-js/src/index.ts
+++ b/packages/core/postgrest-js/src/index.ts
@@ -14,6 +14,7 @@ export {
   PostgrestBuilder,
   PostgrestError,
 }
+/** @hidden */
 export default {
   PostgrestClient,
   PostgrestQueryBuilder,