GitHub: Get project for organization

← Projects operations · Get started

Operation github.projects_get_for_org

Provider route: GET /orgs/{org}/projectsV2/{project_number}. Alter supplies the connection’s credentials and routing.

Call through Alter

Install @alter-ai/sdk @alter-ai/github with npm, or alter-sdk-github with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { GitHubIntegration } from "@alter-ai/github";

async function execute(input: Parameters<GitHubIntegration["projects"]["projectsGetForOrg"]>[0]) {
  const app = new App({ apiKey: process.env.ALTER_API_KEY! });
  try {
    const provider = new GitHubIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
    const call = await provider.projects.projectsGetForOrg(input);
    const result = await call.wait();
    return result.bodyJson();
  } finally {
    await app.close();
  }
}

import os
from alter_sdk import App
from alter_sdk_github import GitHubIntegration

async def execute(arguments):
    async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
        provider = GitHubIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
        call = await provider.projects.projects_get_for_org(arguments)
        result = await call.wait()
        return result.body_json()

Input

Field	Type	Presence	Description and constraints
$	object	Root	Additional keys: not allowed
path	object	Required within parent	Additional keys: not allowed
path.project_number	integer	Required within parent
path.org	string	Required within parent

Response

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

Field	Type	Presence	Description and constraints
$	Model	Root	Expand Get project for user — response body

Referenced models: Get project for user — response body

Schemas

Get project for user — response body

Field	Type	Presence	Description and constraints
$	object	Root	A projects v2 project
closed_at	JSON	Required within parent
closed_at (anyOf 1)	string	Alternative	The time when the project was closed. Format: date-time
closed_at (anyOf 2)	null	Alternative
created_at	string	Required within parent	The time when the project was created. Format: date-time
creator	Model	Required within parent	Expand List users — response body — item
deleted_at	JSON	Required within parent
deleted_at (anyOf 1)	string	Alternative	The time when the project was deleted. Format: date-time
deleted_at (anyOf 2)	null	Alternative
deleted_by	Model	Required within parent	Expand Get an issue — response body — user
description	JSON	Required within parent
description (anyOf 1)	string	Alternative	A short description of the project.
description (anyOf 2)	null	Alternative
id	JSON	Required within parent
id (anyOf 1)	number	Alternative	The unique identifier of the project.
id (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
is_template	boolean	Optional	Whether this project is a template
latest_status_update	Model	Optional	Expand Get project for user — response body — latest status update
node_id	string	Required within parent	The node ID of the project.
number	JSON	Required within parent
number (anyOf 1)	integer	Alternative	The project number.
number (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
owner	Model	Required within parent	Expand List users — response body — item
public	boolean	Required within parent	Whether the project is visible to anyone with access to the owner.
short_description	JSON	Required within parent
short_description (anyOf 1)	string	Alternative	A concise summary of the project.
short_description (anyOf 2)	null	Alternative
state	string	Optional	The current state of the project. Known values: open, closed
title	string	Required within parent	The project title.
updated_at	string	Required within parent	The time when the project was last updated. Format: date-time

Referenced models: Get project for user — response body — latest status update, Get an issue — response body — user, List users — response body — item

Get project for user — response body — latest status update

Field	Type	Presence	Description and constraints
$	JSON	Root
$ (anyOf 1)	object	Alternative	An status update belonging to a project
$ (anyOf 1).body	JSON	Optional
$ (anyOf 1).body (anyOf 1)	string	Alternative	Body of the status update
$ (anyOf 1).body (anyOf 2)	null	Alternative
$ (anyOf 1).created_at	string	Required within parent	The time when the status update was created. Format: date-time
$ (anyOf 1).creator	Model	Optional	Expand List users — response body — item
$ (anyOf 1).id	JSON	Required within parent
$ (anyOf 1).id (anyOf 1)	number	Alternative	The unique identifier of the status update.
$ (anyOf 1).id (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 1).node_id	string	Required within parent	The node ID of the status update.
$ (anyOf 1).project_node_id	string	Optional	The node ID of the project that this status update belongs to.
$ (anyOf 1).start_date	string	Optional	The start date of the period covered by the update. Format: date
$ (anyOf 1).status	JSON	Optional
$ (anyOf 1).status (anyOf 1)	string	Alternative	The current status. Known values: INACTIVE, ON_TRACK, AT_RISK, OFF_TRACK, COMPLETE
$ (anyOf 1).status (anyOf 2)	null	Alternative
$ (anyOf 1).target_date	string	Optional	The target date associated with the update. Format: date
$ (anyOf 1).updated_at	string	Required within parent	The time when the status update was last updated. Format: date-time
$ (anyOf 2)	null	Alternative

Referenced models: List users — response body — item

Get an issue — response body — user

Field	Type	Presence	Description and constraints
$	JSON	Root
$ (anyOf 1)	Model	Alternative	Expand Get an issue — response body — user A Git Hub user
$ (anyOf 2)	null	Alternative

Referenced models: Get an issue — response body — user A Git Hub user

List users — response body — item

Field	Type	Presence	Description and constraints
$	object	Root	A GitHub user.
avatar_url	string	Required within parent	Format: uri
email	JSON	Optional
email (anyOf 1)	string	Alternative
email (anyOf 2)	null	Alternative
events_url	string	Required within parent
followers_url	string	Required within parent	Format: uri
following_url	string	Required within parent
gists_url	string	Required within parent
gravatar_id	JSON	Required within parent
gravatar_id (anyOf 1)	string	Alternative
gravatar_id (anyOf 2)	null	Alternative
html_url	string	Required within parent	Format: uri
id	JSON	Required within parent
id (anyOf 1)	integer	Alternative	Format: int64
id (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
login	string	Required within parent
name	JSON	Optional
name (anyOf 1)	string	Alternative
name (anyOf 2)	null	Alternative
node_id	string	Required within parent
organizations_url	string	Required within parent	Format: uri
received_events_url	string	Required within parent	Format: uri
repos_url	string	Required within parent	Format: uri
site_admin	boolean	Required within parent
starred_at	string	Optional
starred_url	string	Required within parent
subscriptions_url	string	Required within parent	Format: uri
type	string	Required within parent
url	string	Required within parent	Format: uri
user_view_type	string	Optional

Get an issue — response body — user A Git Hub user

Field	Type	Presence	Description and constraints
$	object	Root	A GitHub user.
avatar_url	string	Required within parent	Format: uri
email	JSON	Optional
email (anyOf 1)	string	Alternative
email (anyOf 2)	null	Alternative
events_url	string	Required within parent
followers_url	string	Required within parent	Format: uri
following_url	string	Required within parent
gists_url	string	Required within parent
gravatar_id	JSON	Required within parent
gravatar_id (anyOf 1)	string	Alternative
gravatar_id (anyOf 2)	null	Alternative
html_url	string	Required within parent	Format: uri
id	JSON	Required within parent
id (anyOf 1)	integer	Alternative	Format: int64
id (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
login	string	Required within parent
name	JSON	Optional
name (anyOf 1)	string	Alternative
name (anyOf 2)	null	Alternative
node_id	string	Required within parent
organizations_url	string	Required within parent	Format: uri
received_events_url	string	Required within parent	Format: uri
repos_url	string	Required within parent	Format: uri
site_admin	boolean	Required within parent
starred_at	string	Optional
starred_url	string	Required within parent
subscriptions_url	string	Required within parent	Format: uri
type	string	Required within parent
url	string	Required within parent	Format: uri
user_view_type	string	Optional

Policy, approvals and errors

SDK function policy ID: github.projects_get_for_org. Catalog operation: projects/get-for-org. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Pinned headers: {"X-GitHub-Api-Version": "2026-03-10", "User-Agent": "Alter", "Accept": "application/vnd.github+json"}

Official provider source