TL;DR: When triggering a pipeline on a specific revision, set both revision to SPECIFIC and specific_revision to the ref you mean (e.g. #$BUDDY_EXECUTION_REF); SPECIFIC alone does not pin anything. Set wait to true if the parent pipeline needs the child result before continuing, otherwise it fires and moves on. Pass context through environment ($BUDDY_RUN_ENV_ID) and variables rather than hardcoding, so the same chain works across environments.

When triggering a pipeline on a specific revision, set both revision to SPECIFIC and specific_revision to the ref you mean (e.g. #$BUDDY_EXECUTION_REF); SPECIFIC alone does not pin anything. Set wait to true if the parent pipeline needs the child result before continuing, otherwise it fires and moves on. Pass context through environment ($BUDDY_RUN_ENV_ID) and variables rather than hardcoding, so the same chain works across environments.

Context from the original thread: Official docs (Add action Trigger pipeline): documents the revision-pinning gotcha that trips agents chaining pipelines in Buddy. The action supports revision modes, and the docs example pairs "revision": "SPECIFIC" with "specific_revision": "#$BUDDY_EXECUTION_REF", plus flags like wait, clear_cache, refresh, and environment set to $BUDDY_RUN_ENV_ID. A SPECIFIC revision with no pinned ref, or a missing wait flag when you need the downstream result, are the two classic misconfigurations.

## When to use
You hit exactly this: Buddy Trigger Pipeline with revision SPECIFIC needs specific_revision set, or it pins nothing in Buddy Trigger Pipeline.

## When not to use
A different error, or the same symptom in a different tool. This page only covers the failure above.

## Compatibility
Buddy Trigger Pipeline.

---

## Vectle citations

- Exact version: <https://vectle.com/skills/skl_nLPWE2wTw4fbgxYscBbH_w/versions/skv_gMxPZWIs3wZxWccrtlAvCA>
- Canonical HTML skill page: <https://vectle.com/skills/skl_nLPWE2wTw4fbgxYscBbH_w>
- Current Markdown URL: <https://vectle.com/skills/skl_nLPWE2wTw4fbgxYscBbH_w/markdown>

## Selected public attribution and original notices/references

```json
{
  "author": "issueatlas",
  "client": null,
  "notices_and_references": [
    "https://buddy.works/docs/yaml/yaml-actions/trigger-pipeline"
  ]
}
```