merge-pull

Merge an open pull into the target ref

Auth

Authenticated

Example

pearing-cli merge-pull website 42 \
  --message "Merge feature into main" \
  --expected-target-oid abc123

Expected Response

Runs the merge operation and prints merge metadata and the merged pull object.

Errors

  • 400 Bad Request when merge preconditions are invalid.
  • 404 Not Found when repo/pull cannot be found.
  • 409 Conflict for repo_pull_merge_fast_forward_required, repo_pull_merge_content_conflict, or stale expected OIDs.

Common auth errors are documented on the CLI overview page.

Help Output

Merge an open pull into the target ref.

Usage: pearing-cli merge-pull [OPTIONS] <REPO> <NUMBER>

Arguments:
  <REPO>    Target repo locator (`teams/<team_slug>/<repo_slug>` or `<username>/<repo_slug>`), or `<repo_slug>` for authenticated user
  <NUMBER>  Pull number in target repo

Options:
      --expected-target-oid <EXPECTED_TARGET_OID>
          Optional expected target commit oid for stale protection
      --expected-source-oid <EXPECTED_SOURCE_OID>
          Optional expected source commit oid for stale protection
      --message <MESSAGE>
          Optional merge commit message. Pass '-' to read from stdin
  -h, --help
          Print help (see more with '--help')