github-repo-actions-api — Lists

naftiko: 1.0.0-alpha2
info:
  label: github-repo-actions-api — Lists
  description: 'github-repo-actions-api — Lists. 15 operations. Lead operation: GitHub List Artifacts for Repository. Self-contained
    Naftiko capability covering one Github business surface.'
  tags:
  - Github
  - Lists
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    GITHUB_API_KEY: GITHUB_API_KEY
capability:
  consumes:
  - type: http
    namespace: repo-actions-lists
    baseUri: ''
    description: github-repo-actions-api — Lists business capability. Self-contained, no shared references.
    resources:
    - name: repos-owner-repo-actions-artifacts
      path: /repos/{owner}/{repo}/actions/artifacts
      operations:
      - name: listartifactsforrepository
        method: GET
        description: GitHub List Artifacts for Repository
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Authorization
          in: header
          type: string
        - name: X-GitHub-Api-Version
          in: header
          type: string
        - name: Accept
          in: header
          type: string
    - name: repos-owner-repo-actions-caches
      path: /repos/{owner}/{repo}/actions/caches
      operations:
      - name: listgithubactionscachesforrepository
        method: GET
        description: GitHub List Github Actions Caches for Repository
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Authorization
          in: header
          type: string
        - name: X-GitHub-Api-Version
          in: header
          type: string
        - name: Accept
          in: header
          type: string
    - name: repos-owner-repo-actions-organization-secrets
      path: /repos/{owner}/{repo}/actions/organization-secrets
      operations:
      - name: listrepositoryorganizationsecrets
        method: GET
        description: GitHub List Repository Organization Secrets
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Authorization
          in: header
          type: string
        - name: X-GitHub-Api-Version
          in: header
          type: string
        - name: Accept
          in: header
          type: string
    - name: repos-owner-repo-actions-organization-variables
      path: /repos/{owner}/{repo}/actions/organization-variables
      operations:
      - name: listrepositoryorganizationvariables
        method: GET
        description: GitHub List Repository Organization Variables
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Authorization
          in: header
          type: string
        - name: X-GitHub-Api-Version
          in: header
          type: string
        - name: Accept
          in: header
          type: string
    - name: repos-owner-repo-actions-runners
      path: /repos/{owner}/{repo}/actions/runners
      operations:
      - name: listselfhostedrunnersforrepository
        method: GET
        description: GitHub List Self-hosted Runners for Repository
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Authorization
          in: header
          type: string
        - name: X-GitHub-Api-Version
          in: header
          type: string
        - name: Accept
          in: header
          type: string
    - name: repos-owner-repo-actions-runners-downloads
      path: /repos/{owner}/{repo}/actions/runners/downloads
      operations:
      - name: listrunnerapplicationsforrepository
        method: GET
        description: GitHub List Runner Applications for Repository
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Authorization
          in: header
          type: string
        - name: X-GitHub-Api-Version
          in: header
          type: string
        - name: Accept
          in: header
          type: string
    - name: repos-owner-repo-actions-runners-runner_id-labels
      path: /repos/{owner}/{repo}/actions/runners/{runner_id}/labels
      operations:
      - name: listlabelsforselfhostedrunnerforrepository
        method: GET
        description: GitHub List Labels for Self-hosted Runner for Repository
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Authorization
          in: header
          type: string
        - name: X-GitHub-Api-Version
          in: header
          type: string
        - name: Accept
          in: header
          type: string
    - name: repos-owner-repo-actions-runs
      path: /repos/{owner}/{repo}/actions/runs
      operations:
      - name: listworkflowrunsforrepository
        method: GET
        description: GitHub List Workflow Runs for Repository
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Authorization
          in: header
          type: string
        - name: X-GitHub-Api-Version
          in: header
          type: string
        - name: Accept
          in: header
          type: string
    - name: repos-owner-repo-actions-runs-run_id-artifacts
      path: /repos/{owner}/{repo}/actions/runs/{run_id}/artifacts
      operations:
      - name: listworkflowrunartifacts
        method: GET
        description: GitHub List Workflow Run Artifacts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Authorization
          in: header
          type: string
        - name: X-GitHub-Api-Version
          in: header
          type: string
        - name: Accept
          in: header
          type: string
    - name: repos-owner-repo-actions-runs-run_id-attempts-attempt_number-jobs
      path: /repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}/jobs
      operations:
      - name: listjobsforworkflowrunattempt
        method: GET
        description: GitHub List Jobs for Workflow Run Attempt
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Authorization
          in: header
          type: string
        - name: X-GitHub-Api-Version
          in: header
          type: string
        - name: Accept
          in: header
          type: string
    - name: repos-owner-repo-actions-runs-run_id-jobs
      path: /repos/{owner}/{repo}/actions/runs/{run_id}/jobs
      operations:
      - name: listjobsforworkflowrun
        method: GET
        description: GitHub List Jobs for Workflow Run
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: filter
          in: query
          type: string
          description: Filters jobs by their `completed_at` timestamp. `latest` returns jobs from the most recent execution
            of the workflow run. `all` returns all jobs for workflow ru
        - name: Authorization
          in: header
          type: string
        - name: X-GitHub-Api-Version
          in: header
          type: string
        - name: Accept
          in: header
          type: string
    - name: repos-owner-repo-actions-secrets
      path: /repos/{owner}/{repo}/actions/secrets
      operations:
      - name: listrepositorysecrets
        method: GET
        description: GitHub List Repository Secrets
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Authorization
          in: header
          type: string
        - name: X-GitHub-Api-Version
          in: header
          type: string
        - name: Accept
          in: header
          type: string
    - name: repos-owner-repo-actions-variables
      path: /repos/{owner}/{repo}/actions/variables
      operations:
      - name: listrepositoryvariables
        method: GET
        description: GitHub List Repository Variables
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Authorization
          in: header
          type: string
        - name: X-GitHub-Api-Version
          in: header
          type: string
        - name: Accept
          in: header
          type: string
    - name: repos-owner-repo-actions-workflows
      path: /repos/{owner}/{repo}/actions/workflows
      operations:
      - name: listrepositoryworkflows
        method: GET
        description: GitHub List Repository Workflows
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Authorization
          in: header
          type: string
        - name: X-GitHub-Api-Version
          in: header
          type: string
        - name: Accept
          in: header
          type: string
    - name: repos-owner-repo-actions-workflows-workflow_id-runs
      path: /repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs
      operations:
      - name: listworkflowrunsforworkflow
        method: GET
        description: GitHub List Workflow Runs for Workflow
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Authorization
          in: header
          type: string
        - name: X-GitHub-Api-Version
          in: header
          type: string
        - name: Accept
          in: header
          type: string
    authentication:
      type: bearer
      token: '{{env.GITHUB_API_KEY}}'
  exposes:
  - type: rest
    namespace: repo-actions-lists-rest
    port: 8080
    description: REST adapter for github-repo-actions-api — Lists. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/repos/{owner}/{repo}/actions/artifacts
      name: repos-owner-repo-actions-artifacts
      description: REST surface for repos-owner-repo-actions-artifacts.
      operations:
      - method: GET
        name: listartifactsforrepository
        description: GitHub List Artifacts for Repository
        call: repo-actions-lists.listartifactsforrepository
        with:
          Authorization: rest.Authorization
          X-GitHub-Api-Version: rest.X-GitHub-Api-Version
          Accept: rest.Accept
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repos/{owner}/{repo}/actions/caches
      name: repos-owner-repo-actions-caches
      description: REST surface for repos-owner-repo-actions-caches.
      operations:
      - method: GET
        name: listgithubactionscachesforrepository
        description: GitHub List Github Actions Caches for Repository
        call: repo-actions-lists.listgithubactionscachesforrepository
        with:
          Authorization: rest.Authorization
          X-GitHub-Api-Version: rest.X-GitHub-Api-Version
          Accept: rest.Accept
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repos/{owner}/{repo}/actions/organization-secrets
      name: repos-owner-repo-actions-organization-secrets
      description: REST surface for repos-owner-repo-actions-organization-secrets.
      operations:
      - method: GET
        name: listrepositoryorganizationsecrets
        description: GitHub List Repository Organization Secrets
        call: repo-actions-lists.listrepositoryorganizationsecrets
        with:
          Authorization: rest.Authorization
          X-GitHub-Api-Version: rest.X-GitHub-Api-Version
          Accept: rest.Accept
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repos/{owner}/{repo}/actions/organization-variables
      name: repos-owner-repo-actions-organization-variables
      description: REST surface for repos-owner-repo-actions-organization-variables.
      operations:
      - method: GET
        name: listrepositoryorganizationvariables
        description: GitHub List Repository Organization Variables
        call: repo-actions-lists.listrepositoryorganizationvariables
        with:
          Authorization: rest.Authorization
          X-GitHub-Api-Version: rest.X-GitHub-Api-Version
          Accept: rest.Accept
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repos/{owner}/{repo}/actions/runners
      name: repos-owner-repo-actions-runners
      description: REST surface for repos-owner-repo-actions-runners.
      operations:
      - method: GET
        name: listselfhostedrunnersforrepository
        description: GitHub List Self-hosted Runners for Repository
        call: repo-actions-lists.listselfhostedrunnersforrepository
        with:
          Authorization: rest.Authorization
          X-GitHub-Api-Version: rest.X-GitHub-Api-Version
          Accept: rest.Accept
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repos/{owner}/{repo}/actions/runners/downloads
      name: repos-owner-repo-actions-runners-downloads
      description: REST surface for repos-owner-repo-actions-runners-downloads.
      operations:
      - method: GET
        name: listrunnerapplicationsforrepository
        description: GitHub List Runner Applications for Repository
        call: repo-actions-lists.listrunnerapplicationsforrepository
        with:
          Authorization: rest.Authorization
          X-GitHub-Api-Version: rest.X-GitHub-Api-Version
          Accept: rest.Accept
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repos/{owner}/{repo}/actions/runners/{runner-id}/labels
      name: repos-owner-repo-actions-runners-runner-id-labels
      description: REST surface for repos-owner-repo-actions-runners-runner_id-labels.
      operations:
      - method: GET
        name: listlabelsforselfhostedrunnerforrepository
        description: GitHub List Labels for Self-hosted Runner for Repository
        call: repo-actions-lists.listlabelsforselfhostedrunnerforrepository
        with:
          Authorization: rest.Authorization
          X-GitHub-Api-Version: rest.X-GitHub-Api-Version
          Accept: rest.Accept
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repos/{owner}/{repo}/actions/runs
      name: repos-owner-repo-actions-runs
      description: REST surface for repos-owner-repo-actions-runs.
      operations:
      - method: GET
        name: listworkflowrunsforrepository
        description: GitHub List Workflow Runs for Repository
        call: repo-actions-lists.listworkflowrunsforrepository
        with:
          Authorization: rest.Authorization
          X-GitHub-Api-Version: rest.X-GitHub-Api-Version
          Accept: rest.Accept
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repos/{owner}/{repo}/actions/runs/{run-id}/artifacts
      name: repos-owner-repo-actions-runs-run-id-artifacts
      description: REST surface for repos-owner-repo-actions-runs-run_id-artifacts.
      operations:
      - method: GET
        name: listworkflowrunartifacts
        description: GitHub List Workflow Run Artifacts
        call: repo-actions-lists.listworkflowrunartifacts
        with:
          Authorization: rest.Authorization
          X-GitHub-Api-Version: rest.X-GitHub-Api-Version
          Accept: rest.Accept
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repos/{owner}/{repo}/actions/runs/{run-id}/attempts/{attempt-number}/jobs
      name: repos-owner-repo-actions-runs-run-id-attempts-attempt-number-jobs
      description: REST surface for repos-owner-repo-actions-runs-run_id-attempts-attempt_number-jobs.
      operations:
      - method: GET
        name: listjobsforworkflowrunattempt
        description: GitHub List Jobs for Workflow Run Attempt
        call: repo-actions-lists.listjobsforworkflowrunattempt
        with:
          Authorization: rest.Authorization
          X-GitHub-Api-Version: rest.X-GitHub-Api-Version
          Accept: rest.Accept
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repos/{owner}/{repo}/actions/runs/{run-id}/jobs
      name: repos-owner-repo-actions-runs-run-id-jobs
      description: REST surface for repos-owner-repo-actions-runs-run_id-jobs.
      operations:
      - method: GET
        name: listjobsforworkflowrun
        description: GitHub List Jobs for Workflow Run
        call: repo-actions-lists.listjobsforworkflowrun
        with:
          filter: rest.filter
          Authorization: rest.Authorization
          X-GitHub-Api-Version: rest.X-GitHub-Api-Version
          Accept: rest.Accept
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repos/{owner}/{repo}/actions/secrets
      name: repos-owner-repo-actions-secrets
      description: REST surface for repos-owner-repo-actions-secrets.
      operations:
      - method: GET
        name: listrepositorysecrets
        description: GitHub List Repository Secrets
        call: repo-actions-lists.listrepositorysecrets
        with:
          Authorization: rest.Authorization
          X-GitHub-Api-Version: rest.X-GitHub-Api-Version
          Accept: rest.Accept
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repos/{owner}/{repo}/actions/variables
      name: repos-owner-repo-actions-variables
      description: REST surface for repos-owner-repo-actions-variables.
      operations:
      - method: GET
        name: listrepositoryvariables
        description: GitHub List Repository Variables
        call: repo-actions-lists.listrepositoryvariables
        with:
          Authorization: rest.Authorization
          X-GitHub-Api-Version: rest.X-GitHub-Api-Version
          Accept: rest.Accept
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repos/{owner}/{repo}/actions/workflows
      name: repos-owner-repo-actions-workflows
      description: REST surface for repos-owner-repo-actions-workflows.
      operations:
      - method: GET
        name: listrepositoryworkflows
        description: GitHub List Repository Workflows
        call: repo-actions-lists.listrepositoryworkflows
        with:
          Authorization: rest.Authorization
          X-GitHub-Api-Version: rest.X-GitHub-Api-Version
          Accept: rest.Accept
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/repos/{owner}/{repo}/actions/workflows/{workflow-id}/runs
      name: repos-owner-repo-actions-workflows-workflow-id-runs
      description: REST surface for repos-owner-repo-actions-workflows-workflow_id-runs.
      operations:
      - method: GET
        name: listworkflowrunsforworkflow
        description: GitHub List Workflow Runs for Workflow
        call: repo-actions-lists.listworkflowrunsforworkflow
        with:
          Authorization: rest.Authorization
          X-GitHub-Api-Version: rest.X-GitHub-Api-Version
          Accept: rest.Accept
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: repo-actions-lists-mcp
    port: 9090
    transport: http
    description: MCP adapter for github-repo-actions-api — Lists. One tool per consumed operation, routed inline through this
      capability's consumes block.
    tools:
    - name: github-list-artifacts-repository
      description: GitHub List Artifacts for Repository
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: repo-actions-lists.listartifactsforrepository
      with:
        Authorization: tools.Authorization
        X-GitHub-Api-Version: tools.X-GitHub-Api-Version
        Accept: tools.Accept
      outputParameters:
      - type: object
        mapping: $.
    - name: github-list-github-actions-caches
      description: GitHub List Github Actions Caches for Repository
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: repo-actions-lists.listgithubactionscachesforrepository
      with:
        Authorization: tools.Authorization
        X-GitHub-Api-Version: tools.X-GitHub-Api-Version
        Accept: tools.Accept
      outputParameters:
      - type: object
        mapping: $.
    - name: github-list-repository-organization-secrets
      description: GitHub List Repository Organization Secrets
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: repo-actions-lists.listrepositoryorganizationsecrets
      with:
        Authorization: tools.Authorization
        X-GitHub-Api-Version: tools.X-GitHub-Api-Version
        Accept: tools.Accept
      outputParameters:
      - type: object
        mapping: $.
    - name: github-list-repository-organization-variables
      description: GitHub List Repository Organization Variables
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: repo-actions-lists.listrepositoryorganizationvariables
      with:
        Authorization: tools.Authorization
        X-GitHub-Api-Version: tools.X-GitHub-Api-Version
        Accept: tools.Accept
      outputParameters:
      - type: object
        mapping: $.
    - name: github-list-self-hosted-runners
      description: GitHub List Self-hosted Runners for Repository
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: repo-actions-lists.listselfhostedrunnersforrepository
      with:
        Authorization: tools.Authorization
        X-GitHub-Api-Version: tools.X-GitHub-Api-Version
        Accept: tools.Accept
      outputParameters:
      - type: object
        mapping: $.
    - name: github-list-runner-applications-repository
      description: GitHub List Runner Applications for Repository
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: repo-actions-lists.listrunnerapplicationsforrepository
      with:
        Authorization: tools.Authorization
        X-GitHub-Api-Version: tools.X-GitHub-Api-Version
        Accept: tools.Accept
      outputParameters:
      - type: object
        mapping: $.
    - name: github-list-labels-self-hosted
      description: GitHub List Labels for Self-hosted Runner for Repository
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: repo-actions-lists.listlabelsforselfhostedrunnerforrepository
      with:
        Authorization: tools.Authorization
        X-GitHub-Api-Version: tools.X-GitHub-Api-Version
        Accept: tools.Accept
      outputParameters:
      - type: object
        mapping: $.
    - name: github-list-workflow-runs-repository
      description: GitHub List Workflow Runs for Repository
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: repo-actions-lists.listworkflowrunsforrepository
      with:
        Authorization: tools.Authorization
        X-GitHub-Api-Version: tools.X-GitHub-Api-Version
        Accept: tools.Accept
      outputParameters:
      - type: object
        mapping: $.
    - name: github-list-workflow-run-artifacts
      description: GitHub List Workflow Run Artifacts
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: repo-actions-lists.listworkflowrunartifacts
      with:
        Authorization: tools.Authorization
        X-GitHub-Api-Version: tools.X-GitHub-Api-Version
        Accept: tools.Accept
      outputParameters:
      - type: object
        mapping: $.
    - name: github-list-jobs-workflow-run
      description: GitHub List Jobs for Workflow Run Attempt
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: repo-actions-lists.listjobsforworkflowrunattempt
      with:
        Authorization: tools.Authorization
        X-GitHub-Api-Version: tools.X-GitHub-Api-Version
        Accept: tools.Accept
      outputParameters:
      - type: object
        mapping: $.
    - name: github-list-jobs-workflow-run-2
      description: GitHub List Jobs for Workflow Run
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: repo-actions-lists.listjobsforworkflowrun
      with:
        filter: tools.filter
        Authorization: tools.Authorization
        X-GitHub-Api-Version: tools.X-GitHub-Api-Version
        Accept: tools.Accept
      outputParameters:
      - type: object
        mapping: $.
    - name: github-list-repository-secrets
      description: GitHub List Repository Secrets
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: repo-actions-lists.listrepositorysecrets
      with:
        Authorization: tools.Authorization
        X-GitHub-Api-Version: tools.X-GitHub-Api-Version
        Accept: tools.Accept
      outputParameters:
      - type: object
        mapping: $.
    - name: github-list-repository-variables
      description: GitHub List Repository Variables
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: repo-actions-lists.listrepositoryvariables
      with:
        Authorization: tools.Authorization
        X-GitHub-Api-Version: tools.X-GitHub-Api-Version
        Accept: tools.Accept
      outputParameters:
      - type: object
        mapping: $.
    - name: github-list-repository-workflows
      description: GitHub List Repository Workflows
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: repo-actions-lists.listrepositoryworkflows
      with:
        Authorization: tools.Authorization
        X-GitHub-Api-Version: tools.X-GitHub-Api-Version
        Accept: tools.Accept
      outputParameters:
      - type: object
        mapping: $.
    - name: github-list-workflow-runs-workflow
      description: GitHub List Workflow Runs for Workflow
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: repo-actions-lists.listworkflowrunsforworkflow
      with:
        Authorization: tools.Authorization
        X-GitHub-Api-Version: tools.X-GitHub-Api-Version
        Accept: tools.Accept
      outputParameters:
      - type: object
        mapping: $.