{"id":13539941,"url":"https://github.com/peter-evans/create-or-update-project-card","last_synced_at":"2025-04-05T06:09:53.538Z","repository":{"id":42685603,"uuid":"262235382","full_name":"peter-evans/create-or-update-project-card","owner":"peter-evans","description":"A GitHub action to create or update a project card","archived":false,"fork":false,"pushed_at":"2025-03-25T15:02:13.000Z","size":4120,"stargazers_count":70,"open_issues_count":2,"forks_count":17,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-29T05:10:03.628Z","etag":null,"topics":["automation","github-action","project-cards","projects","workflow"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/peter-evans.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"peter-evans"}},"created_at":"2020-05-08T05:30:13.000Z","updated_at":"2025-03-25T15:02:08.000Z","dependencies_parsed_at":"2023-09-26T17:46:36.433Z","dependency_job_id":"b41afa71-fe9b-4f93-9c26-2f12c4b25edf","html_url":"https://github.com/peter-evans/create-or-update-project-card","commit_stats":{"total_commits":267,"total_committers":3,"mean_commits":89.0,"dds":0.2921348314606742,"last_synced_commit":"5080b5678f8c7ec52ae921288c341603b3790674"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peter-evans%2Fcreate-or-update-project-card","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peter-evans%2Fcreate-or-update-project-card/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peter-evans%2Fcreate-or-update-project-card/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peter-evans%2Fcreate-or-update-project-card/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/peter-evans","download_url":"https://codeload.github.com/peter-evans/create-or-update-project-card/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247294541,"owners_count":20915340,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","github-action","project-cards","projects","workflow"],"created_at":"2024-08-01T09:01:34.837Z","updated_at":"2025-04-05T06:09:53.523Z","avatar_url":"https://github.com/peter-evans.png","language":"TypeScript","funding_links":["https://github.com/sponsors/peter-evans"],"categories":["TypeScript"],"sub_categories":[],"readme":"# Create or Update Project Card\n[![CI](https://github.com/peter-evans/create-or-update-project-card/workflows/CI/badge.svg)](https://github.com/peter-evans/create-or-update-project-card/actions?query=workflow%3ACI)\n[![GitHub Marketplace](https://img.shields.io/badge/Marketplace-Create%20or%20Update%20Project%20Card-blue.svg?colorA=24292e\u0026colorB=0366d6\u0026style=flat\u0026longCache=true\u0026logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAAOCAYAAAAfSC3RAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAM6wAADOsB5dZE0gAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAERSURBVCiRhZG/SsMxFEZPfsVJ61jbxaF0cRQRcRJ9hlYn30IHN/+9iquDCOIsblIrOjqKgy5aKoJQj4O3EEtbPwhJbr6Te28CmdSKeqzeqr0YbfVIrTBKakvtOl5dtTkK+v4HfA9PEyBFCY9AGVgCBLaBp1jPAyfAJ/AAdIEG0dNAiyP7+K1qIfMdonZic6+WJoBJvQlvuwDqcXadUuqPA1NKAlexbRTAIMvMOCjTbMwl1LtI/6KWJ5Q6rT6Ht1MA58AX8Apcqqt5r2qhrgAXQC3CZ6i1+KMd9TRu3MvA3aH/fFPnBodb6oe6HM8+lYHrGdRXW8M9bMZtPXUji69lmf5Cmamq7quNLFZXD9Rq7v0Bpc1o/tp0fisAAAAASUVORK5CYII=)](https://github.com/marketplace/actions/create-or-update-project-card)\n\nA GitHub action to create or update a project card.\n\n\u003e [!IMPORTANT]  \n\u003e This action does not support v2 projects and is now [deprecated](https://github.com/peter-evans/create-or-update-project-card/issues/64#issuecomment-2338205349).\n\n## Usage\n\n### Create a project card\n\n```yml\n      - name: Create or Update Project Card\n        uses: peter-evans/create-or-update-project-card@v3\n        with:\n          project-name: My project\n          column-name: My column\n          issue-number: 1\n```\n\n### Update a project card\n\nIf a card already exists in project `My project` for issue `1`, the action will check if the card is in column `My second column`.\nIf not in the specified column, the action will move the card.\n\n```yml\n      - name: Create or Update Project Card\n        uses: peter-evans/create-or-update-project-card@v3\n        with:\n          project-name: My project\n          column-name: My second column\n          issue-number: 1\n```\n\n### Create a card in an organization or user project\n\nWhen creating cards in an organization or user project, a `repo` and `admin:org` scoped [Personal Access Token (PAT)](https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token) is required.\n\n```yml\n      - name: Create or Update Project Card\n        uses: peter-evans/create-or-update-project-card@v3\n        with:\n          token: ${{ secrets.PAT }}\n          project-location: my-org\n          project-name: My project\n          column-name: My second column\n          issue-number: 1\n```\n\n### Create a card for all new issues\n\n```yml\non:\n  issues:\n    types: [opened]\njobs:\n  createCard:\n    runs-on: ubuntu-latest\n    steps:\n      - name: Create or Update Project Card\n        uses: peter-evans/create-or-update-project-card@v3\n        with:\n          project-name: My project\n          column-name: My column\n```\n\n### Create a card for all new pull requests\n\nNote that the following example uses the [`pull_request_target`](https://docs.github.com/en/actions/reference/events-that-trigger-workflows#pull_request_target) event, *not* `pull_request`.\nIn *public* repositories this action does not work in `pull_request` workflows when triggered by forks.\nThis is due to token restrictions put in place by GitHub Actions.\nPrivate repositories can be configured to [enable workflows](https://docs.github.com/en/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository#enabling-workflows-for-private-repository-forks) from forks to run without restriction. See [here](https://github.com/peter-evans/create-pull-request/blob/main/docs/concepts-guidelines.md#restrictions-on-repository-forks) for further explanation.\n\n```yml\non:\n  pull_request_target:\n    types: [opened]\njobs:\n  createCard:\n    runs-on: ubuntu-latest\n    steps:\n      - name: Create or Update Project Card\n        uses: peter-evans/create-or-update-project-card@v3\n        with:\n          project-name: My project\n          column-name: My column\n          issue-number: ${{ github.event.number }}\n```\n\n### Action inputs\n\n| Name | Description | Default |\n| --- | --- | --- |\n| `token` | `GITHUB_TOKEN` or a `repo` scoped [PAT](https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token). | `GITHUB_TOKEN` |\n| `project-location` | The location of the project. Either a repository, organization, or user. | `github.repository` (current repository) |\n| `project-number` | (**semi-required**) The number of the project. Either `project-number` OR `project-name` must be supplied. | |\n| `project-name` | (**semi-required**) The name of the project. Either `project-number` OR `project-name` must be supplied. Note that a project's name is not unique. The action will use the first matching project found. | |\n| `column-name` | (**required**) The name of the column to add a card to, or move an existing card to. | |\n| `repository` | The GitHub repository containing the issue or pull request. | `github.repository` (current repository) |\n| `issue-number` | The issue or pull request number to associate with the card. | `github.event.issue.number` |\n\n### Action outputs\n\nThe action outputs `card-id` for use in later workflow steps.\n\n```yml\n      - name: Create or Update Project Card\n        id: coupc\n        uses: peter-evans/create-or-update-project-card@v3\n        with:\n          project-name: My project\n          column-name: My column\n          issue-number: 1\n      - name: Check output\n        run: echo ${{ steps.coupc.outputs.card-id }}\n```\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeter-evans%2Fcreate-or-update-project-card","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpeter-evans%2Fcreate-or-update-project-card","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeter-evans%2Fcreate-or-update-project-card/lists"}