api-cookbook

api-cookbook copied to clipboard

Request

The Pivotal Tracker export format includes columns labeled “Pull Request” and “Git Branch”, but the current Pivotal Importer does not import this data.

It would be ideal for the Pivotal Importer to relate the imported Shortcut Stories with the given Pull Requests (or Branches if not related Pull Request exists).

Approach

Reviewing Shortcut's public API, there is not currently a way to create the first-class VCS association between an imported Shortcut Story and a GitHub PR. That association has to be initiated from the GitHub end.

As a step in that direction, the Pivotal Importer can certainly record the URL(s) as an external link on the Shortcut Story, so at least it's discoverable from within Shortcut.