Skip to content

Document publicationFilter for REST, GraphQL, and Document Service API#3274

Open
innerdvations wants to merge 3 commits into
mainfrom
cms/document-publication-filter
Open

Document publicationFilter for REST, GraphQL, and Document Service API#3274
innerdvations wants to merge 3 commits into
mainfrom
cms/document-publication-filter

Conversation

@innerdvations

@innerdvations innerdvations commented Jun 18, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Add dedicated publicationFilter reference pages for the REST API and Document Service API, with GraphQL documented as a new section on the GraphQL page.
  • Document cohort values, status × publicationFilter behavior, default-status differences across API surfaces, Content Manager mapping, validation, and deprecated hasPublishedVersion.
  • Cross-link from status, parameters, document-service method tables, and Draft & Publish; update sidebar navigation and regenerate LLM artifacts.

Test plan

  • yarn generate-llms and yarn llms:generate-and-validate pass
  • yarn build in docusaurus/
  • Spot-check sidebar order: REST → Parameters → … → Status → Publication filter → Populate & Select
  • Verify links from Draft & Publish feature page to new API docs

Related PRs: CMS 25793 with a follow-up fix in #26400

Adds dedicated reference pages for derived Draft & Publish cohorts, cross-links from status/parameters/draft-and-publish, and updates outdated count() guidance.
Fix REST page navigation and example consistency, tighten Document Service
prose for readers and llms-code extraction, and regenerate LLM artifacts.
@innerdvations innerdvations requested a review from pwizla as a code owner June 18, 2026 13:05
@vercel

vercel Bot commented Jun 18, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
documentation Ready Ready Preview, Comment Jun 29, 2026 10:45am

Request Review

@github-actions github-actions Bot added internal PRs created by the Strapi core team pr: new content PRs for new product features or new documentation sections source: repo PRs/issues not targeting a specific documentation but rather affecting the whole repo labels Jun 18, 2026
@innerdvations

Copy link
Copy Markdown
Collaborator Author

@pwizla This is one from a few months ago that we wanted a soft launch on to make sure it was stable, but is fine to publicize now. It looks like my AI went a bit overboard on detailing this, so feel free to trim it down or just pull out the relevant details/examples and replace it

@innerdvations

Copy link
Copy Markdown
Collaborator Author

Also, we may want to remove the reference to hasPublishedVersion -- as far as I know it was never officially documented, so we probably don't want to even include it here at all, it seems weird to add it to docs already deprecated. What do you think?

@pwizla

pwizla commented Jun 18, 2026

Copy link
Copy Markdown
Collaborator

Thanks for the contribution, Ben! I'll review this tomorrow.
Would you please have a base strapi/strapi PR or branch I can relate to? (I do remember the hasPublishedVersion topic, PR #2966 , but would like to know which branch my code exploring agents should look at 👀 )

@innerdvations

Copy link
Copy Markdown
Collaborator Author

It was added in strapi/strapi#25793 with a follow-up fix in strapi/strapi#26400 (although that one you can probably leave out)

@pwizla pwizla self-assigned this Jun 19, 2026
@pwizla pwizla added this to the 6.28.1 milestone Jun 19, 2026
@pwizla

pwizla commented Jun 19, 2026

Copy link
Copy Markdown
Collaborator

It was added in strapi/strapi#25793 with a follow-up fix in strapi/strapi#26400 (although that one you can probably leave out)

Thank you, Ben. I've just updated the PR description with these. I'll actually move the review to next Monday, to focus on some other work today. Will keep you posted!

@pwizla pwizla modified the milestones: 6.28.1, 7.0.0 Jun 26, 2026
Adopt Endpoint-based document-service docs from main and add publicationFilter parameters.
Regenerate llms.txt and llms-full.txt.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

internal PRs created by the Strapi core team pr: new content PRs for new product features or new documentation sections source: repo PRs/issues not targeting a specific documentation but rather affecting the whole repo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants