GitHub releases as timeline markers

Releases, tags and closed user-facing issues.

What does not arrive

  • Pull requests.
  • Draft releases. Only action published is kept.
  • Issues without the user-facing label, and issues that are not closed.
  • Pushes that are not tags (refs/tags/).

What arrives

Release published. Kind release.

FieldWhat it is
kindrelease
titleRelease name, otherwise tag name, otherwise Release.
external_idRelease id.
occurred_atpublished_at, otherwise created_at.
urlhtml_url.

Push to a tag. Kind release.

FieldWhat it is
kindrelease
titleTag name.
external_idafter (commit SHA), otherwise the tag.
occurred_athead_commit.timestamp, when present.
urlRepository releases/tag URL, otherwise compare URL.

Issue closed with the user-facing label. Kind task.

FieldWhat it is
kindtask
titleIssue title.
external_idIssue id.
occurred_atclosed_at.
urlhtml_url.

Signature

HMAC-SHA256 of the raw body, header x-hub-signature-256 (sha256= plus hex).

Set it up under Settings → Webhooks in your project.