An open API service indexing awesome lists of open source software.

https://github.com/factbirdhq/action-add-pr-to-project

Adds a PR to the specified Project
https://github.com/factbirdhq/action-add-pr-to-project

Last synced: 3 months ago
JSON representation

Adds a PR to the specified Project

Awesome Lists containing this project

README

        

# Add Pull Request to Project

A GitHub action that lets you automatically add Pull Requests to your Projects.

You will need the Column ID of the specific column it should go into. Extract this by clicking on the `...` of the column, choosing "Copy column link" and then taking the last number of the URL, e.g. in `https://github.com/orgs/BlackbirdHQ/projects/99999#column-123456` the Column ID is `123456`.

Screenshot 2020-02-03 at 20 37 38

# Example Workflow

```yml
name: 'Bot: Add Pull Request to Project'
on:
pull_request:
types:
# Only add it when the PR is opened.
- opened

jobs:
add-to-project:
runs-on: ubuntu-latest
steps:
- uses: BlackbirdHQ/action-add-pr-to-project@release/v1
with:
# The Column ID of the project
columnId: 123456
token: ${{ secrets.GITHUB_TOKEN }}
projectToken: ${{ secrets.GITHUB_TOKEN }} # Or custom secrets.ORG_GITHUB_TOKEN
```

**Note:** If you want to add the PR to a project that's not in the repo itself, you will need to create an access token with the permissions for this. For example, in the screenshot below, I'm setting up a token to add the PR to an organization project, and storing it in secrets under `ORG_GITHUB_TOKEN`.

The `token` is used to get the PR id and information, while the `projectToken` might have a different access scope, and is used to add the PR to the project.

Screenshot 2020-02-03 at 21 04 35