---
title: "get reference · RUAL Documentation"
description: "RUAL github block."
canonical: https://docs.rual.nl/block-types/github/githubconnection_git_get_reference
language: en
---

# get reference

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

- flow `flow`

- connection `githubconnection`

- success `condition`

- data `object`

- error `value`

| `github` |
| --- |

A typical wiring for [get reference](https://docs.rual.nl/block-types/github/githubconnection_git_get_reference): 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; the `flow` out pin feeds [debug](https://docs.rual.nl/block-types/state%20ui/state_debug).

![Studio canvas example for the get reference block: typical wiring for get reference.](https://docs.rual.nl/canvas-examples/githubconnection_git_get_reference.png)

### Version history

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