---
title: "getRunner"
canonical: "https://support.appfire.com/space/BCCLI/65768069/getRunner"
format: markdown
---
> Macro (aura-html)

See also: [Actions](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65766635)

> Macro (details)
> 
> | **Description** | Get workspace or repository runner by name or UUID. If a name is not unique, the first runner found will be returned. |
> | --- | --- |
> | **Required Parameters** | ([workspace](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65765634) or [repository](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65766277)), [name](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65766239) |
> | **Optional Parameters** |  |
> | **Type** | [Get](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65768932/Action+Types#ActionTypes-Get) |
> | **Category** | [Pipelines](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65766329/Action+Categories#ActionCategories-Pipelines) |
> | **Output Formats** |  |
> | **Replacement Variables** | runner, runnerUuid, runnerType, runnerLabels, runnerOauthClientId, repository, repositoryFullKey, repositoryName, repositoryUuid, workspace, workspaceName, workspaceUuid |
> | **Since Version** | 10.4 |
> | **Examples** |  |

## Related How To's

> Macro (cql-query)