Skip to content

fix(kno-15032): document object recipient workflow runs - #1652

Open
scotidodson wants to merge 1 commit into
mainfrom
sd-KNO-15032-clarify-object-trigger-runs
Open

fix(kno-15032): document object recipient workflow runs#1652
scotidodson wants to merge 1 commit into
mainfrom
sd-KNO-15032-clarify-object-trigger-runs

Conversation

@scotidodson

Copy link
Copy Markdown
Contributor

KNO-15032: Clarify that object triggers generate a workflow run for the object itself

Summary

  • Object triggers with subscribers were documented as fanning out to subscribers, but the run for the object itself was only mentioned in a single FAQ accordion. Because of that, it was easy to miss and be caught by surprise.
  • Adds a short "Object workflow runs" section to the objects page covering why the run happens, what it's used for, and how to conditionally execute steps by recipient type.
  • Renamed the subscriptions section to "Triggering a workflow for object subscribers" (trying to shorten TOC....), updated its body to state the object run, and added an FAQ on skipping it.
  • Updated the fan-out sentences on the objects and trigger API pages to include the object run.

Changes

  • content/concepts/objects.mdx — object subscribers intro now covers the object run; added an "Object workflow runs" section; shortened "Referencing object data in templates" to "Referencing object data".
  • content/concepts/subscriptions.mdx — renamed the trigger section, corrected the "How subscriptions work" fan-out sentence, updated one FAQ accordion and added another on skipping the object run.
  • content/send-notifications/triggering-workflows/api.mdx — trigger FAQ now includes the object run.

@linear-code

linear-code Bot commented Aug 28, 2026

Copy link
Copy Markdown

KNO-15032

@vercel

vercel Bot commented Aug 28, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Aug 28, 2026 10:36pm

Request Review

@scotidodson scotidodson changed the title fix(kno-15032): document object workflow runs fix(kno-15032): document object recipient workflow runs Aug 28, 2026

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Risk MEDIUM: Clarifies that object workflow triggers generate a run for the object itself in addition to fan-out to subscribers.

Reasons

  • Changes span multiple documentation sections (content/concepts/ and content/send-notifications/)
  • Only MDX content files are modified — no components, layouts, lib, styles, or build config
  • Small diff (22 additions, 9 deletions across 3 files)
  • No new pages, sidebar navigation changes, or OpenAPI spec updates
  • Author scotidodson is a known repository contributor

Notes

  • Verify the new "Object workflow runs" section and updated fan-out language are technically accurate
  • Check cross-links between objects, subscriptions, and trigger API pages resolve correctly
  • Confirm the new FAQ on skipping object runs aligns with current product behavior and support guidance
  • Review step condition examples (__typename, collection) for accuracy
Open in Web View Automation 

Sent by Cursor Automation: Docs PR classifier

@scotidodson
scotidodson requested a review from a team August 28, 2026 22:38

@cellomatt cellomatt left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

🙏

</Accordion>
<Accordion title="Can I notify both the object AND the subscribers of the object?">
Yes, by default when you trigger a workflow for an object that has
Yes. By default when you trigger a workflow for an object that has

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
Yes. By default when you trigger a workflow for an object that has
Yes. When you trigger a workflow for an object that has

/>

## Referencing object data in templates
## Object workflow runs

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I might place this section above the subscribers heading, because it's relevant whether or not an object has subscribers, but not a big deal either way.

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.

2 participants