{"id":22181554,"url":"https://github.com/gfarb/get-project-next-fields","last_synced_at":"2026-04-16T10:32:34.696Z","repository":{"id":65159894,"uuid":"466193305","full_name":"gfarb/get-project-next-fields","owner":"gfarb","description":"GitHub Action to retrieve Project Next Field data for a Project (beta) owned by a User or Organization.","archived":false,"fork":false,"pushed_at":"2022-03-08T16:43:11.000Z","size":735,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-23T19:37:09.509Z","etag":null,"topics":["github","github-actions","github-projects","graphql","project-management","project-next","projectnext"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/gfarb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-03-04T16:25:39.000Z","updated_at":"2023-06-29T14:51:26.000Z","dependencies_parsed_at":"2023-01-13T15:43:39.595Z","dependency_job_id":null,"html_url":"https://github.com/gfarb/get-project-next-fields","commit_stats":{"total_commits":8,"total_committers":1,"mean_commits":8.0,"dds":0.0,"last_synced_commit":"5e69ff21686776cb6981ea1787d1606062b103b0"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gfarb%2Fget-project-next-fields","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gfarb%2Fget-project-next-fields/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gfarb%2Fget-project-next-fields/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gfarb%2Fget-project-next-fields/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gfarb","download_url":"https://codeload.github.com/gfarb/get-project-next-fields/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245334908,"owners_count":20598389,"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":["github","github-actions","github-projects","graphql","project-management","project-next","projectnext"],"created_at":"2024-12-02T09:40:35.408Z","updated_at":"2026-04-16T10:32:29.666Z","avatar_url":"https://github.com/gfarb.png","language":"JavaScript","readme":"# [Get Project Next Fields Action](https://github.com/marketplace/actions/get-project-next-fields)\nGitHub Action to retrieve [Project Next Field data](https://docs.github.com/en/graphql/reference/objects#projectnextfield) for a [Project (beta)](https://docs.github.com/en/issues/trying-out-the-new-projects-experience) owned by a User or Organization.\n## Description\nThe `Get Project Next Fields` GitHub Action was created to ease the pain of maintaining a file of constants or hardcoding values pertaining to Project Next Fields for use within a GitHub CI/CD flow.\n\nThis GitHub Action uses the GitHub GraphQL API and pagination to retrieve all Project Next Field data for a Project (beta) that is owned by a User or Organization. The action returns an easily-parseable object representing a map of all Project Next Fields for a Project (beta).\n## Getting Started\n### How to use\n##### Example #1 - User-Owned Project:\n- Assumptions:\n  - You want to query Project Next Fields for a Project (beta) that is owned by the `gfarb` User and is assigned the number `1`\n  - You have a repository secret named `PAT` that stores a Personal Access Token scoped with the appropriate permissions\n- Workflow: \n\t```\n\tsteps:\n\t   - name: Get Project Next-Fields\n\t      id: project-next-fields\n\t      uses: gfarb/get-project-next-fields@0.1\n\t      with:\n\t        PAT: ${{ secrets.PAT }}\n\t\t USER: gfarb\n\t\t PROJECT_NEXT_NUMBER: 1\n\t```\n##### Example #2 - Organization-Owned Project:\n- Assumptions:\n  - You want to query Project Next Fields for a Project (beta) that is owned by the `github` Organization and is assigned the number `1234`\n  - You have a repository secret named `PAT` that stores a Personal Access Token scoped with the appropriate permissions\n- Workflow: \n\t```\n\tsteps:\n\t   - name: Get Project Next-Fields\n\t      id: project-next-fields\n\t      uses: gfarb/get-project-next-fields@0.1\n\t      with:\n\t        PAT: ${{ secrets.PAT }}\n\t\t ORG: github\n\t\t PROJECT_NEXT_NUMBER: 1234\n\t```\n### Parsing output\n##### Example #1:\n- Assumptions:\n   - You want to find the `id` of a `single select` Project Next Field value for a specific project\n   - The `PROJECT_NEXT_FIELDS` output of the `Get Project Next Fields` GitHub Action step was passed as an input to your future step called `PROJECT_NEXT_FIELDS`\n   - The Project Next Field is named `SingleSelectFieldName` and the value is named `SingleSelectField_Value1`\n- Bash:\n   ```\n   echo \"$PROJECT_NEXT_FIELDS\" | \\\n      jq '.SingleSelectFieldName.settings.options |\n      map(select(.name == \"SingleSelectField_Value1\")) |\n      .[].id'\n   ```\n- JavaScript:\n   ```\n   const selectFieldValueId = JSON.parse(core.getInput('PROJECT_NEXT_FIELDS'))\n      .SingleSelectFieldName\n      .settings\n      .options\n      .filter(fieldOption =\u003e {\n         return  fieldOption.name === 'SingleSelectField_Value1'\n      })[0].id;\n   ```\n## Supporting Docs\n- [About projects (beta)](https://docs.github.com/en/issues/trying-out-the-new-projects-experience/about-projects)\n- [Using the API to manage projects (beta)](https://docs.github.com/en/issues/trying-out-the-new-projects-experience/using-the-api-to-manage-projects)\n- [GitHub GraphQL Explorer](https://docs.github.com/en/graphql/overview/explorer)\n## Version History\n* 0.1\n  * Initial Release\n## License\nThis project is licensed under the MIT License - see the LICENSE.md file for details\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgfarb%2Fget-project-next-fields","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgfarb%2Fget-project-next-fields","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgfarb%2Fget-project-next-fields/lists"}