{"data":{"slug":"peter-evans-create-pull-request","name":"create-pull-request","tagline":"A GitHub action to create a pull request for changes to your repository in the actions workspace","github_url":"https://github.com/peter-evans/create-pull-request","owner":"peter-evans","repo":"create-pull-request","owner_avatar_url":"https://avatars.githubusercontent.com/u/18365890?v=4","primary_language":"TypeScript","stars":2814,"forks":547,"topics":["actions-workspace","automation","ci-cd","create-pull-request","github-action","pull-request","workflow"],"archived":false,"github_pushed_at":"2026-07-01T12:37:42+00:00","maintenance_label":"Active","url":"https://www.graphcanon.com/tools/peter-evans-create-pull-request","markdown_url":"https://www.graphcanon.com/tools/peter-evans-create-pull-request.md","api_url":"https://www.graphcanon.com/api/graphcanon/tools/peter-evans-create-pull-request","graph_url":"https://www.graphcanon.com/api/graphcanon/graph?tool=peter-evans-create-pull-request","description":"A GitHub action to create a pull request for changes to your repository in the actions workspace","homepage_url":null,"license":"MIT","open_issues":17,"watchers":24,"ai_summary":null,"readme_excerpt":"# <img width=\"24\" height=\"24\" src=\"docs/assets/logo.svg\"> Create Pull Request\n\n\n\nA GitHub action to create a pull request for changes to your repository in the actions workspace.\n\nChanges to a repository in the Actions workspace persist between steps in a workflow.\nThis action is designed to be used in conjunction with other steps that modify or add files to your repository.\nThe changes will be automatically committed to a new branch and a pull request created.\n\nCreate Pull Request action will:\n\n1. Check for repository changes in the Actions workspace. This includes:\n   - untracked (new) files\n   - tracked (modified) files\n   - commits made during the workflow that have not been pushed\n2. Commit all changes to a new branch, or update an existing pull request branch.\n3. Create or update a pull request to merge the branch into the base&mdash;the branch checked out in the workflow.\n\n## Documentation\n\n- [Concepts, guidelines and advanced usage](docs/concepts-guidelines.md)\n- [Examples](docs/examples.md)\n- [Updating between versions](docs/updating.md)\n- [Common issues](docs/common-issues.md)\n\n## Usage\n\n```yml\n      - uses: actions/checkout@v6\n\n      # Make changes to pull request here\n\n      - name: Create Pull Request\n        uses: peter-evans/create-pull-request@v8\n```\n\nYou can also pin to a [specific release](https://github.com/peter-evans/create-pull-request/releases) version in the format `@v8.x.x`\n\n### Workflow permissions\n\nFor this action to work you must explicitly allow GitHub Actions to create pull requests.\nThis setting can be found in a repository's settings under Actions > General > Workflow permissions.\n\nFor repositories belonging to an organization, this setting can be managed by admins in organization settings under Actions > General > Workflow permissions.\n\n### Action inputs\n\nAll inputs are **optional**. If not set, sensible defaults will be used.\n\n| Name | Description | Default |\n| --- | --- | --- |\n| `token` | The token that the action will use to create and update the pull request. See [token](#token). | `GITHUB_TOKEN` |\n| `branch-token` | The token that the action will use to create and update the branch. See [branch-token](#branch-token). | Defaults to the value of `token` |\n| `path` | Relative path under `GITHUB_WORKSPACE` to the repository. | `GITHUB_WORKSPACE` |\n| `add-paths` | A comma or newline-separated list of file paths to commit. Paths should follow git's [pathspec](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddefpathspecapathspec) syntax. See [Add specific paths](#add-specific-paths). | If no paths are specified, all new and modified files are added. |\n| `commit-message` | The message to use when committing changes. See [commit-message](#commit-message). | `[create-pull-request] automated change` |\n| `committer` | The committer name and email address in the format `Display Name <email@address.com>`. Defaults to the GitHub Actions bot user on github.com. | `github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>` |\n| `author` | The author name and email address in the format `Display Name <email@address.com>`. Defaults to the user who triggered the workflow run. | `${{ github.actor }} <${{ github.actor_id }}+${{ github.actor }}@users.noreply.github.com>` |\n| `signoff` | Add [`Signed-off-by`](https://git-scm.com/docs/git-commit#Documentation/git-commit.txt---signoff) line by the committer at the end of the commit log message. | `false` |\n| `branch` | The pull request branch name. | `create-pull-request/patch` |\n| `delete-branch` | Delete the `branch` if it doesn't have an active pull request associated with it. See [delete-branch](#delete-branch). | `false` |\n| `branch-suffix` | The branch suffix type when using the alternative branching strategy. Valid values are `random`, `timestamp` and `short-commit-hash`. See [Alternative strategy](#alternative-strategy---always-create-a-new-pull-request-branch) for details. | |\n| `base` | Sets the pull request base bra","github_created_at":"2019-07-16T10:53:23+00:00","created_at":"2026-07-15T10:48:22.157697+00:00","updated_at":"2026-07-15T10:48:24.940367+00:00","categories":[{"slug":"developer-tools","name":"Developer Tools","url":"https://www.graphcanon.com/categories/developer-tools","markdown_url":"https://www.graphcanon.com/categories/developer-tools.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/developer-tools"}],"tags":[{"slug":"actions-workspace","name":"actions-workspace"},{"slug":"automation","name":"automation"},{"slug":"ci-cd","name":"ci-cd"},{"slug":"create-pull-request","name":"create-pull-request"},{"slug":"github-action","name":"github-action"},{"slug":"pull-request","name":"pull-request"},{"slug":"typescript","name":"typescript"},{"slug":"workflow","name":"workflow"}],"trust":{"provenance":{"is_fork":false,"github_id":197176365,"owner_type":"User","methodology":"github_public_v1","parent_repo":null,"near_duplicate_slugs":[]},"computed_at":"2026-07-15T10:48:23.098Z","maintenance":{"label":"Active","score":82,"methodology":"github_public_v1","releases_90d":0,"days_since_push":13,"last_release_at":"2026-04-10T16:27:57Z"},"security_summary":{"status":"no_lockfile","scanner":null,"low_count":0,"high_count":0,"last_scan_at":"2026-07-15T10:48:23.480Z","medium_count":0,"scan_profile":"none","critical_count":0}},"capability_facts":{"mcp":{"source":"repo_scan","observed_at":"2026-07-15T10:48:22.882Z","server_manifest":false},"scan":{"source":"repo_scan","observed_at":"2026-07-15T10:48:22.882Z"},"languages":{"value":["typescript","javascript"],"source":"github.language+package.json","observed_at":"2026-07-15T10:48:22.882Z"},"license_spdx":{"value":"MIT","source":"github.license","observed_at":"2026-07-15T10:48:22.882Z"}}}}