Skip to content

The open alternative to Salesforce, designed for AI.

Let workspace admins switch to the new REST metadata API format from the Lab (#28282)

Charles Bochet8265dbd8d97c
diff --git a/packages/twenty-docs/user-guide/settings/capabilities/community-settings.mdx b/packages/twenty-docs/user-guide/settings/capabilities/community-settings.mdx
index d8427d14b75..3a362b297a8 100644
--- a/packages/twenty-docs/user-guide/settings/capabilities/community-settings.mdx
+++ b/packages/twenty-docs/user-guide/settings/capabilities/community-settings.mdx
@@ -11,7 +11,8 @@ The Community section allows you to enable Early Access features before they're
Early Access features are capabilities that are still being tested before general availability.
-No features are in Early Access right now. New ones will appear in the **Features** section when they become available.
+**Currently in Early Access:**
+* **New REST Metadata API Format**: `/rest/metadata/objects` and `/rest/metadata/fields` return objects and fields directly, without the legacy `data.objects` / `data.fields` wrapper. Workspaces created since May 2026 already use it. The legacy format will be discontinued on November 15, 2026; turn this on to test your integrations before then.
### How to Enable Early Access Features
1. Go to **Settings → Community**
diff --git a/packages/twenty-server/src/engine/core-modules/feature-flag/constants/public-feature-flag.const.ts b/packages/twenty-server/src/engine/core-modules/feature-flag/constants/public-feature-flag.const.ts
index 8e67afd95fe..d3ee9dfecbb 100644
--- a/packages/twenty-server/src/engine/core-modules/feature-flag/constants/public-feature-flag.const.ts
+++ b/packages/twenty-server/src/engine/core-modules/feature-flag/constants/public-feature-flag.const.ts
@@ -13,6 +13,15 @@ export type PublicFeatureFlag = {
};
export const PUBLIC_FEATURE_FLAGS: PublicFeatureFlag[] = [
+ {
+ key: FeatureFlagKey.IS_REST_METADATA_API_NEW_FORMAT_DIRECT,
+ metadata: {
+ label: 'New REST Metadata API Format',
+ description:
+ 'Return objects and fields from /rest/metadata without the legacy data.objects / data.fields wrapper. The legacy format will be discontinued on November 15, 2026.',
+ icon: 'IconApi',
+ },
+ },
...(process.env.CLOUDFLARE_API_KEY
? [
// {