Skip to content

[Blocked on release of post-trigger hooks] Document trigger hook payload context - #632

Open
omerbensaadon wants to merge 4 commits into
mainfrom
tembo/split-trigger-hook-docs
Open

[Blocked on release of post-trigger hooks] Document trigger hook payload context#632
omerbensaadon wants to merge 4 commits into
mainfrom
tembo/split-trigger-hook-docs

Conversation

@omerbensaadon

@omerbensaadonomerbensaadon commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Updates the agents feature page to mention post-trigger hooks as an option for transforming webhook payloads or fetching extra context.
  • Expands the trigger agent OpenAPI description to document TRIGGER_PAYLOAD behavior and expected hook output.
  • Fixes the beta link target to /beta/agent-post-trigger-hook.

Notes

This is stacked on top of #631 (tembo/beta-agent-pre-run-script) so the diff contains only the non-beta/ documentation changes while the linked hidden beta page exists in the base branch.

Validation

  • Checked for merge conflicts against origin/tembo/beta-agent-pre-run-script: already up to date.
  • Ran git diff --check.

Want tembo to make any changes? Add a comment with @tembo and i'll get back to work!

View on TemboView Agent SettingsView on slack


Note

Low Risk
Documentation-only changes with no runtime or API behavior modifications.

Overview
Documentation-only updates for webhook agent triggers and post-trigger hooks.

On features/agents.mdx, the webhook section now states the trigger body is JSON event context and points readers to agent post-trigger hooks when they need to reshape the payload or fetch extra data. It documents that hooks read TRIGGER_PAYLOAD and that stdout (Markdown, text, or JSON) is merged into the agent’s starting context.

On openapi.documented.yml, the Trigger Agent operation description and request body text are expanded: the body is event context with concrete field examples (issue URLs, ticket IDs, Slack links, Sentry IDs, priorities, instructions). When a post-trigger hook is configured, the same body is available as TRIGGER_PAYLOAD, and hook stdout adds dynamic context. The OpenAPI example gains an instructions field.

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

Co-authored-by: Omer <omerbensaadon@gmail.com>
@tembotemboBot added the tembo Pull request created by Tembo label Jul 17, 2026
@tembo

temboBot commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Requesting review from @benja who has experience with the following files modified in this PR:

  • features/agents.mdx

@tembo
temboBot requested a review from benjaJuly 17, 2026 10:41
@omerbensaadonomerbensaadon changed the title Document trigger hook payload context[Blocked on release of post-trigger hooks] Document trigger hook payload contextJul 17, 2026
temboBotand others added 2 commits July 17, 2026 11:01
Co-authored-by: Omer <omerbensaadon@gmail.com>
Co-authored-by: Omer <omerbensaadon@gmail.com>
@tembo

temboBot commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Closing this because the changes were moved onto #631 as requested.

@tembotemboBot closed this Jul 17, 2026
@tembotemboBot reopened this Jul 17, 2026
Base automatically changed from tembo/beta-agent-pre-run-script to mainJuly 17, 2026 15:53
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

blockedtemboPull request created by Tembo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@omerbensaadon