Skip to content

chore: Add GitHub workflow to sync public API docs (no-changelog) #15985

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 4 commits into
base: master
Choose a base branch
from

Conversation

MarcL
Copy link
Contributor

@MarcL MarcL commented Jun 3, 2025

Summary

When merging #12329 I found out that the public API OpenAPI schema is not synced with the n8n-io/n8n-docs repo.

This PR adds a GitHub workflow to sync any changes to the schema and raise a PR in the docs repo when a PR is merged to master.

Related Linear tickets, Github issues, and Community forum posts

Related: #15969

Review / Merge checklist

  • PR title and summary are descriptive. (conventions)
  • [ ] Docs updated or follow-up ticket created.
  • [ ] Tests included.
  • [ ] PR Labeled with release/backport (if the PR is an urgent fix that needs to be backported)

Copy link
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

cubic found 3 issues across 2 files. Review them in cubic.dev

React with 👍 or 👎 to teach cubic. Tag @cubic-dev-ai to give specific feedback.


# TODO: Check this
# The token needs write access to the docs repository to push branches and create PRs
token: ${{ secrets.GITHUB_TOKEN }}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Default GITHUB_TOKEN lacks permissions to create PRs in external repositories

Suggested change
token: ${{ secrets.GITHUB_TOKEN }}
token: ${{ secrets.DOCS_REPO_PAT }}

Copy link

codecov bot commented Jun 3, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

📢 Thoughts on this report? Let us know!

@n8n-assistant n8n-assistant bot added core Enhancement outside /nodes-base and /editor-ui n8n team Authored by the n8n team labels Jun 3, 2025
@MarcL MarcL force-pushed the marcl/sync-public-api-docs branch from 055bdbb to 4cfc1d2 Compare June 5, 2025 09:44
@MarcL MarcL force-pushed the marcl/sync-public-api-docs branch from 4cfc1d2 to 163b83b Compare June 5, 2025 15:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
core Enhancement outside /nodes-base and /editor-ui n8n team Authored by the n8n team
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant