Bind Project Relative Ref

Category: Pr Project

Use the token from `prProjectOpen.storeBindingIn` or `prProjectCreate.storeBindingIn` as `projectRef`. A bare GUID is accepted only when it currently identifies one open resource. The returned `~prbind_...` ref and canonical refs derived from it are exact but valid only inside the current DSL run; convert them with `prMakeProjectRelativeRef` before persisting.

Inputs

Input	Required	Value Kind	Types	Enum Values
ref	yes	expression	reference	—
projectRef	yes	expression	reference, string	—

Notes

• Accepts a project-root-relative locator plus the runtime token stored by prProjectOpen.storeBindingIn or prProjectCreate.storeBindingIn.
• A bare project GUID is accepted only when it uniquely identifies one open resource; the expression creates an exact binding before returning.
• Resolves and validates the target immediately, then returns a canonical bound runtime ref carrying ~prbind_....
• The result and canonical refs derived from it are run-scoped. Reuse them inside the current workflow, but never persist them; convert a derived ref back with prMakeProjectRelativeRef first.

See Also

• Premiere Reference Paths: Explains Premiere reference path strings for project items, sequences, tracks, timeline items, markers, components, and parameters.
• Make Project Relative Ref: Parses an explicit Premiere object ref and removes only its project.