Skip to content

link_reference

Link an external reference to a Polygraph session.

Attaches an external reference to the session timeline. A reference is another Polygraph session, a GitHub PR, a GitHub issue, or a Linear ticket. This replaces the former link_session tool. To link another session, pass a reference with type "session".

NameTypeRequiredDescription
sessionIdstringyesThe Polygraph session ID, or a supported Polygraph app session URL (/s/<session-id> or /orgs/<org-id>/sessions/<session-id>).
referenceobjectyesThe external reference to link. Set type to "session", "github_pr", "github_issue", or "linear_ticket". Every shape takes a url and a label. The "session" shape also takes sessionId, the linked Polygraph session ID.