Skip to content
Proud to collaborate with Microsoft for Startups

github.repos.list_repos ​

List GitHub repositories for a user or organisation

List GitHub repositories for a user or organisation.

Inputs:

  • owner: GitHub username or organisation name (required).
  • is_org: True if owner is an organisation (optional, default: false).
  • repo_type: all | public | private | forks | sources | member (optional, default: all).
  • per_page: Results per page, 1–100 (optional, default: 30).

Outputs (terminal state_data):

  • repos: list of
  • total: int — number of repos returned (first page only)

Plugin required: context.get_plugin("github") must expose .token.

Overview ​

PropertyValue
Workflow typeAtomic
LibraryApp-github
Version1.0

Input Schema ​

FieldTypeRequiredDefaultDescription
ownerstringYes—GitHub username or organisation name
is_orgbooleanNo—True if owner is an organisation (default: false)
repo_typestringNo—all
per_pageintegerNo—Results per page 1–100 (default: 30)
organization_uuiduuidNo—Optional organization context

Output Schema ​

FieldTypeRequiredDefaultDescription
ownerstringNo——
is_orgbooleanNo——
repo_typestringNo——
per_pageintegerNo——
organization_uuiduuidNo——
reposlistNo——
totalintegerNo——
failure_reasonstringNo——
failure_typestringNo——
failed_actionstringNo——
failed_at_statestringNo——
failed_stepstringNo——
failed_layerstringNo——
errorstringNo——
error_typestringNo——

States ​

StateInitialTerminalSuccessAuto-advanceDescription
pendingYesNo—execute—
completedNoYesYes——
failedNoYesNo——

State Diagram ​

Transitions ​

FromActionToDescription
pendingexecutecompleted—
* (any state)failfailed—

API Usage ​

bash
POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "github.repos.list_repos",
  "initial_data": {
    "owner": "value"
  }
}