Skip to content

Update Postgres FAQ & OpenAPI docs#6280

Merged
theory merged 1 commit into
mainfrom
fix-pg-openapi
May 26, 2026
Merged

Update Postgres FAQ & OpenAPI docs#6280
theory merged 1 commit into
mainfrom
fix-pg-openapi

Conversation

@theory
Copy link
Copy Markdown
Contributor

@theory theory commented May 26, 2026

Summary

Uncomment and correct the APIs that weren't yet implemented at the time I originally wrote the docs. Also change the IDs from UBIDs to UUIDs and remove storageSize from requests, as it's no longer needed.

Update the FAQ with information about Query Performance Insights, link to the OpenAPI docs, fix the number of extensions, and do some mild copy editing.

Checklist


Note

Low Risk
Markdown-only documentation changes with no runtime or security impact.

Overview
Updates Managed Postgres user-facing docs to match shipped product behavior and current API shapes.

The FAQ now documents Query Performance Insights (with a blog link and Query Insights tab) instead of a “coming soon” note, points Terraform readers to OpenAPI as well as the console, revises the supported extension count to over 90, and applies small clarifications in the PgBouncer / prepared-statement sections.

The OpenAPI guide uncomments and refreshes examples: list/create/read flows use UUID service IDs and realistic response fields; create no longer includes storageSize in the request body; the config example uses pgConfig / pgBouncerConfig and shows the restart warning in the API response.

Reviewed by Cursor Bugbot for commit 3be5ec6. Bugbot is set up for automated code reviews on this repo. Configure here.

@theory theory requested a review from deeox May 26, 2026 12:02
@theory theory self-assigned this May 26, 2026
@theory theory requested a review from a team as a code owner May 26, 2026 12:02
@vercel
Copy link
Copy Markdown

vercel Bot commented May 26, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
clickhouse-docs Ready Ready Preview, Comment May 26, 2026 4:11pm
4 Skipped Deployments
Project Deployment Actions Updated (UTC)
clickhouse-docs-jp Ignored Ignored May 26, 2026 4:11pm
clickhouse-docs-ko Ignored Ignored Preview May 26, 2026 4:11pm
clickhouse-docs-ru Ignored Ignored Preview May 26, 2026 4:11pm
clickhouse-docs-zh Ignored Ignored Preview May 26, 2026 4:11pm

Request Review

@mintlify
Copy link
Copy Markdown

mintlify Bot commented May 26, 2026

Docs PR opened: ClickHouse/mintlify-docs-dev#61

Updated the Managed Postgres FAQ and OpenAPI guide with corrected examples, UUID identifiers, removed storageSize, and minor copy edits.

Uncomment and correct the APIs that weren't yet implemented at the time
I originally wrote the docs. Also change the IDs from UBIDs to UUIDs and
remove `storageSize` from requests, as it's no longer needed.

Update the FAQ with information about Query Performance Insights, link
to the OpenAPI docs, fix the number of extensions, and do some mild copy
editing.
@theory theory merged commit 3be5ec6 into main May 26, 2026
18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants