Skip to content

docs: CUB-4728 document private cubes and lineage stubs in the Metadata API - #12008

Draft
MikeNitsenko wants to merge 2 commits into
masterfrom
claude/metadata-api-private-cubes
Draft

MikeNitsenko wants to merge 2 commits into
masterfrom
claude/metadata-api-private-cubes

Conversation

@MikeNitsenko

Copy link
Copy Markdown
Contributor

Check List

  • Tests have been run in packages where changes have been made if available — docs only
  • Linter has been run for changed code — docs only
  • Tests for the changes have been added if not covered yet — docs only
  • Docs have been added / updated if required

Issue Reference this PR resolves

CUB-4728. Documents the Metadata API behaviour from cubedevinc/cube-runtime#1162.

Description of Changes Made

Updates the Metadata API section of the REST (JSON) API reference (docs-mintlify/reference/core-data-apis/rest-api/reference.mdx):

  • /v1/entities: list items now include public, and the list includes private cubes returned as lineage stubs. Example updated.
  • /v1/entities/{name} and /v1/entities/all: new public field on entities and members. sql and is_primary_key are noted as omitted on stubs. Examples updated.
  • New "Private cubes and members" subsection:
    • what a lineage stub contains, and how public is reported on stub cubes and stub members
    • every reference resolves within the response, and views report the tables they read through private cubes
    • 404 for a private cube that no public member references
    • filter on public to keep only public entities
    • hidden members of cubes with data access policies are never stubbed or used for lineage
    • one stub example

The stub example was checked against the output of the builder on cubedevinc/cube-runtime#1162.

Merge timing: this describes behaviour that ships with cubedevinc/cube-runtime#1162. It's a draft until that change is released to Cube Cloud, so the docs don't run ahead of the product.

🤖 Generated with Claude Code

https://claude.ai/code/session_0173XoBwpEFcgJPe6ehxBDrA


Generated by Claude Code

…ta API

Metadata API entities and members now report `public`, and private cubes
or members that public members reference are returned as lineage stubs so
every reference resolves. Document the `public` field, what a stub
contains, the 404 case, and how data access policies limit stubbing.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0173XoBwpEFcgJPe6ehxBDrA
@mintlify

mintlify Bot commented Sep 25, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
cubed3 🟢 Ready View Preview Sep 25, 2026, 7:08 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@github-actions github-actions Bot added docs Issues that require a documentation improvement pr:community Contribution from Cube.js community members. labels Sep 25, 2026
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0173XoBwpEFcgJPe6ehxBDrA

This branch was successfully deployed

1 active deployment
staging - docs-mintlify — 6ea0b065 Deployed Sep 25, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Issues that require a documentation improvement pr:community Contribution from Cube.js community members.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants