Skip to content

link_reference

Link an external reference to a session.

NameTypeRequiredDescription
sessionIdstringyesThe Polygraph session ID, or a supported Polygraph app session URL. Supported URL paths are /s/<session-id> and /orgs/<org-id>/sessions/<session-id>. URL inputs are normalized to the session ID; the MCP always uses the current Polygraph API configuration.
referenceobjectyesExternal reference to link to a session. Discriminated union on type: "session" (requires url, label, and sessionId — the linked Polygraph session ID or a supported Polygraph app session URL, normalized to the session ID before calling Ocean), "github_pr" (url, label), "github_issue" (url, label), or "linear_ticket" (url, label).