list_projects

photonforge.pda.list_projects(name=None, *, labels=(), visibility=None, role=None, retired=False)

List projects matching metadata, sharing, and retirement filters.

Parameters:

• name (str | None) – Exact project name filter.

• labels (Sequence[str]) – Label filter; any overlap matches.

• visibility (Literal['private', 'organization', 'public'] | None) – Visibility filter.

• role (Literal['owner', 'editor', 'viewer'] | None) – Permission role filter.

• retired (bool) – Whether to search retired projects.

Returns:

Project metadata list.

Return type:

list[dict[str, object]]