View as Markdown
GitHub icon

GitHub ACTION

List Project Statuses

List the options of a Project (V2) Status field (e.g. Todo, In Progress, Done), returning each option's name and id. Use this to discover the valid status values for a project before calling Update Project (V2) Item Status. Get the project number from List Projects. Discover organization logins with List Organizations. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's GitHub account once, then configure and run List Project Statuses from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "github-list-project-statuses",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    github: { authProvisionId: "apn_xxxxxxx" },
    owner: "Owner",
    repo: "Repository",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

List Project Statuses inputs
Property Type Description
owner Owner string
The account that owns the Project (V2) — an organization login (e.g. my-org), or a repository owner when Repository is also set. Required, and it must come from the user. If the user has not said which owner/organization the project belongs to, ask them — do NOT guess an owner or enumerate organizations to find one. If they named an organization but you need its exact login, use List Organizations. User-owned Projects are not supported.
Required
repo Repository string
Optional. The repository name without the owner (e.g. my-repo, not my-org/my-repo) when the Project (V2) is repository-scoped. Leave blank to target an organization-owned Project.
Optional
project Project Number integer
The Project (V2) number as shown in the project URL and UI (e.g. 5 in /orgs/my-org/projects/5) — not the node ID. Required. If the user has not provided it, ask them — do NOT guess. Once you know the owner, you can look up numbers with List Projects.
Required

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
github-list-project-statuses
Version
0.0.2
App
GitHub
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes