Entire push trigger

See Entire Triggers for an overview and Event Triggers for generic options like title, target, and if.

The push trigger handles Entire's ref.created and ref.updated events for branches and tags:

on:
  entire:
    push:
      init:
        commit-sha: ${{ event.git.sha }}

Ref deletions, events without a valid commit SHA, and pushes whose before and after values are identical don't start runs.

To run only on pushes to main, use an if expression:

on:
  entire:
    push:
      if: ${{ event.git.branch == 'main' }}

See Cloning Repositories for a complete checkout example using the event's SHA.

Event fields

The full webhook payload is available under event.entire.push. Payload fields are nested under event.entire.push.event.payload.

PathDescription
event.git.shaThe new commit SHA (after).
event.git.refThe ref that was pushed, such as refs/heads/main or refs/tags/v1.0.0.
event.git.branchThe branch name, or an empty string for a tag.
event.git.tagThe tag name, or an empty string for a branch.
event.entire.push.event.typeref.created or ref.updated.
event.entire.push.event.payload.refThe full ref that was pushed.
event.entire.push.event.payload.beforeThe previous commit SHA.
event.entire.push.event.payload.afterThe new commit SHA.
event.entire.push.event.payload.forcedWhether the push was forced.
event.entire.push.event.payload.repository.idThe Entire repository ID.
event.entire.push.event.payload.repository.pathThe repository path, in project/repository form.
event.entire.push.event.payload.repository.entire_clone_urlThe entire:// clone URL.
event.entire.push.event.payload.pusher.account.idThe pusher's account ID, when a pusher is present.
event.entire.push.event.payload.pusher.account.handleThe pusher's handle, when a pusher is present.