---
title: "list references · RUAL Documentation"
description: "RUAL github block."
canonical: https://docs.rual.nl/block-types/github/githubconnection_git_list_references
language: en
---

# list references

This block is part of the [`github`](https://docs.rual.nl/block-types/github) group and was last modified in core [`v10.4.28`](https://docs.rual.nl/core-versions/100428).

- flow `flow`

- connection required `githubconnection`

- owner required `value` e.g. rual

- repo required `value` e.g. blueprinting

- ref required `value` e.g. heads/master

- namespace required `value` e.g. heads

- flow `flow`

- connection `githubconnection`

- success `condition`

- list `array`

- error `value`

| `github` |
| --- |

A typical wiring for [list references](https://docs.rual.nl/block-types/github/githubconnection_git_list_references): a [function trigger](https://docs.rual.nl/block-types/globals/trigger_custom_function) starts the flow; [open connection](https://docs.rual.nl/block-types/github/function_github_open_connection) feeds the `connection` pin; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `owner` pin; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `repo` pin; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `ref` pin; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `namespace` pin; the `flow` out pin feeds [debug](https://docs.rual.nl/block-types/state%20ui/state_debug).

![Studio canvas example for the list references block: typical wiring for list references.](https://docs.rual.nl/canvas-examples/githubconnection_git_list_references.png)

### Version history

Introduced in [`v10.4.28`](https://docs.rual.nl/core-versions/100428).