docs(data-warehouse): add Cortex source documentation

[inkeep]

Changes

Adds documentation for the new Cortex data warehouse source at /docs/cdp/sources/cortex.

Related PR: PostHog/posthog#73188

What is Cortex?

Cortex is an internal developer portal and service catalog platform that helps engineering teams track services, resources, and domains, measure them against scorecards, and manage team ownership and relationships.

Documentation includes

• Alpha release banner (source is in ALPHA status)
• Prerequisites for setting up the connector
• Instructions for creating an API key in Cortex workspace (Settings → API Keys)
• Sync modes section noting full refresh only (Cortex API doesn't support incremental sync)
• Auto-populated configuration and supported tables sections
• Troubleshooting for common authentication and permission errors

Available tables

• entities - Catalog entities (services, resources, domains)
• scorecards - Scorecards for grading entities
• scorecard_scores - Entity scores against scorecards
• entity_types - Custom entity types
• teams - Teams in Cortex
• relationship_types - Types of entity relationships
• relationships - Connections between entities

---

This PR was created by the Inkeep Content Writer agent, which is maintained by the Docs and Wizard team. Please reach out on Slack for help if needed.

[github-actions]

Deploy preview

Status	Details	Updated (UTC)
🟢 Ready	View preview	Jul 24, 2026 01:05PM

[github-actions]

Vale prose linter → found 0 errors, 1 warnings, 0 suggestions in your markdown

Full report → Copy the linter results into an LLM to batch-fix issues.

Linter being weird? Update the rules!

contents/docs/cdp/sources/cortex.md — 0 errors, 1 warnings, 0 suggestions

Line	Severity	Message	Rule
19:71	warning	Capitalize 'Data Warehouse' for PostHog's product. Use 'Data warehouse' for the general industry concept.	PostHogBase.ProductNames

[github-actions]

Bundle report

Total JS (gzip)

6.74 MiB (no change)

Eager graph (modules shipped in each entrypoint's initial chunks)

Entrypoint	Eager size	Budget	Modules
✅ app	16.19 MiB (no change)	report-only	1985

Largest modules in the app closure

Module	Size
./src/data/mcp-tools.json	918.7 KiB
css ./node_modules/.pnpm/css-loader@5.2.7_webpack@5.101.3/node_modules/css-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[1]!./node_modules/.pnpm/postcss-loader@4.3.0_postcss@8.5.6_webpack@5.101.3/node_modules/postcss-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[2]!./src/styles/global.css	741.7 KiB
./src/components/Stickers/Stickers.tsx	696.4 KiB
./node_modules/.pnpm/@radix-ui+react-icons@1.3.2_react@18.3.1/node_modules/@radix-ui/react-icons/dist/react-icons.esm.js	481.4 KiB
./node_modules/.pnpm/rehype-raw@7.0.0/node_modules/rehype-raw/lib/index.js + 29 modules	395.1 KiB
./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.cjs.js	364.8 KiB
./src/hooks/useCustomers.tsx + 54 modules	355.1 KiB
./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.es.js	354.8 KiB
./node_modules/.pnpm/react-markdown@8.0.7_@types+react@16.14.66_react@18.3.1/node_modules/react-markdown/lib/react-markdown.js + 88 modules	351.4 KiB
./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js	281.9 KiB
./src/components/ProductComparisonTable/index.tsx + 120 modules	278.8 KiB
./src/components/SearchUI/index.tsx + 87 modules	272.1 KiB
./node_modules/.pnpm/framer-motion@10.18.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/framer-motion/dist/es/render/dom/motion.mjs + 109 modules	253.9 KiB
./node_modules/.pnpm/d3@7.9.0/node_modules/d3/src/index.js + 208 modules	247.4 KiB
./src/components/Pricing/PricingSlider/Slider.tsx + 87 modules	239.9 KiB

---

Eager-graph budgets are report-only until a baseline is established. Sizes are gzip of public/**/*.js; eager size is webpack module source bytes for the modules actually shipped in the entrypoint's initial chunks (post-tree-shake).

[github-actions]

Hey @Gilbert09! This docs PR was generated for you by an agent. You're responsible for reviewing and merging it into production.

1. Review and approve the PR
2. Merge the PR
   a. Check the preview env and CI build and merge it yourself
   b. Enable auto-merge if you're confident in the changes