# dev.knotless.listRunners

> Published by [lexicons.knotless.dev](https://lexicon.garden/identity/did:plc:yqsg7znbbhfmj3a2nrpnaerk)

✓ This is the authoritative definition for this NSID.

## Description

The runners a repository names.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:yqsg7znbbhfmj3a2nrpnaerk/dev.knotless.listRunners)
- [Documentation](https://lexicon.garden/lexicon/did:plc:yqsg7znbbhfmj3a2nrpnaerk/dev.knotless.listRunners/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:yqsg7znbbhfmj3a2nrpnaerk/dev.knotless.listRunners/examples)

## Definitions

### `dev.knotless.listRunners`

**Type**: `query`

The accounts a repository names in its record as its runners, as `knotless runners` lists them: those whose checks of it are shown, and who land its merge queue. No authentication; responses are not personalized.

#### Parameters

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `repo` | `string` (at-uri) | Yes | The repository's dev.knotless.repo record, as dev.knotless.getRepo takes it. |

#### Output

**Encoding**: `application/json`

#### Errors

- **NotFound**: No such repository.

### `dev.knotless.listRunners#runners`

**Type**: `object`

A repository's runners, in the order its record names them.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `minutes` | `array` | No | The minutes each runner counts for the repository's owner, where it has counted any; none for a private repository. |
| `runners` | `array` | Yes |  |
| `warning` | `string` | No | After adding a runner to a private repository, why it could not be told of it: adding it again tells it again. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "The accounts a repository names in its record as its runners, as `knotless runners` lists them: those whose checks of it are shown, and who land its merge queue. No authentication; responses are not personalized.",
      "errors": [
        {
          "description": "No such repository.",
          "name": "NotFound"
        }
      ],
      "output": {
        "encoding": "application/json",
        "schema": {
          "ref": "#runners",
          "type": "ref"
        }
      },
      "parameters": {
        "properties": {
          "repo": {
            "description": "The repository's dev.knotless.repo record, as dev.knotless.getRepo takes it.",
            "format": "at-uri",
            "type": "string"
          }
        },
        "required": [
          "repo"
        ],
        "type": "params"
      },
      "type": "query"
    },
    "runners": {
      "description": "A repository's runners, in the order its record names them.",
      "properties": {
        "minutes": {
          "description": "The minutes each runner counts for the repository's owner, where it has counted any; none for a private repository.",
          "items": {
            "ref": "dev.knotless.defs#minutesView",
            "type": "ref"
          },
          "type": "array"
        },
        "runners": {
          "items": {
            "ref": "dev.knotless.defs#actorView",
            "type": "ref"
          },
          "type": "array"
        },
        "warning": {
          "description": "After adding a runner to a private repository, why it could not be told of it: adding it again tells it again.",
          "type": "string"
        }
      },
      "required": [
        "runners"
      ],
      "type": "object"
    }
  },
  "description": "The runners a repository names.",
  "id": "dev.knotless.listRunners",
  "lexicon": 1
}
```