Sign up
All data sources

GitHub Projects

Your account

GitHub Projects V2 connector for managing project boards, items, fields, and views. CRITICAL USAGE RULES: 1. Use listProjects() to discover project IDs before other operations. With no args, it lists the authenticated user's projects. 2. Projects use numeric IDs (project_number) visible in the URL. 3. Items can be issues, PRs, or draft issues. 4. Use GraphQL field IDs from listProjectFields() for field updates. 5. View filters and sorts use GraphQL syntax. AUTHENTICATION: - Uses OAuth token from user's connected GitHub account - Scopes: repo, read:user, user:email, read:org, project

Set up this sourceGet the full contract and schemas as JSON

Sign in with your GitHub Projects account. Included on Free.

What you can ask

  • “What does GitHub Projects have for the area or asset I'm working on?”
  • “Pull the most recent GitHub Projects records and put them in a table.”
  • “What does GitHub Projects cover, and how fresh is the data?”

About this source

GitHub Projects V2 connector for managing project boards, items, fields, and views. CRITICAL USAGE RULES: 1. Use listProjects() to discover project IDs before other operations. With no args, it lists the authenticated user's projects. 2. Projects use numeric IDs (project_number) visible in the URL. 3. Items can be issues, PRs, or draft issues. 4. Use GraphQL field IDs from listProjectFields() for field updates. 5. View filters and sorts use GraphQL syntax. AUTHENTICATION: - Uses OAuth token from user's connected GitHub account - Scopes: repo, read:user, user:email, read:org, project

Connector ID githubProjects

Provenance

PublisherGitHub GraphQL API — Projects V2
Sourcehttps://api.github.com/graphql
API basehttps://api.github.com/
Docshttps://docs.github.com/en/graphql/reference/projects

Freshness & coverage

FreshnessFreshness not declared
GeographicNot declared
TemporalNot declared
AuthenticationCredentials required (OAuth)

Caveats

  • ⚠ PatchOps exposes a curated 15-method Projects V2 subset, not the complete GitHub GraphQL schema.
  • ⚠ This connector requires a separate GitHub OAuth connection with project or read:project scope.
  • ⚠ Mutations are certified only with local exact-wire tests; connected certification is read-only.

› Methods (15)

Technical detail for developers: parameters, pagination, units, and freshness per method.

  • listProjects

    read

    List project boards for a user or organization owner.

  • getProject

    read

    Retrieve a single project board by number or project id.

    Required paramsprojectId or owner and projectNumber

    Use listProjects to obtain projectId or owner/projectNumber; listProjectViews returns viewId and viewNumber.

  • createProject

    write

    Create a new project board with title and optional repository link.

  • updateProject

    write

    Update a project board title, description, readme, closed, or public flag.

  • deleteProject

    write

    Delete a project board permanently by project id.

  • listProjectItems

    read

    List items on a project board, including issues, pull requests, and drafts.

    Required paramsprojectId or owner and projectNumber

    Use listProjects to obtain projectId or owner/projectNumber; listProjectViews returns viewId and viewNumber.

  • addItemToProject

    write

    Add an existing issue or pull request to a project board.

  • createDraftIssue

    write

    Create a draft issue on a project board with title and body.

  • updateProjectItem

    write

    Update a project item field value on a project board.

  • removeItemFromProject

    write

    Remove an item from a project board by item id.

  • listProjectFields

    read

    List custom fields defined on a project board.

    Required paramsprojectId or owner and projectNumber

    Use listProjects to obtain projectId or owner/projectNumber; listProjectViews returns viewId and viewNumber.

  • createProjectField

    write

    Create a project field with a name, data type, and optional single-select options.

  • updateProjectField

    write

    Update a project field name using its field identifier.

  • listProjectViews

    read

    List project views for an owner or project, filtered by project number and owner type.

    Required paramsprojectId or owner and projectNumber

    Use listProjects to obtain projectId or owner/projectNumber; listProjectViews returns viewId and viewNumber.

  • getProjectView

    read

    Retrieve one project view by view identifier or owner and view number.

    Required paramsviewId or owner and projectNumber and viewNumber

    Use listProjects to obtain projectId or owner/projectNumber; listProjectViews returns viewId and viewNumber.