dev.knotless.listRuns Documentation (EN)

The runs of a public repository's workflows that the runners its record names reported, newest first, of every workflow or of one: each as its check, with what it ran on. And the workflows on its default branch, those that run only when asked for by name among them. A page at a time: follow `cursor` until it is absent. No authentication; responses are not personalized.

main query

Parameters

cursor string Optional

The `cursor` of the page before.

limit integer Optional

No description available.

repo string at-uri Required

The repository's dev.knotless.repo record. Its authority may be a handle; a name the repository had before, or an owner it moved from with its agreement, finds it under the name it has now.

workflow string Optional

Only the runs of this workflow, by name.

Output

Encodingapplication/json

cursor string Optional

Absent on the last page.

minutes array Optional

The minutes each of the repository's runners counts for its owner, where it has counted any; none for a private repository.

runs array Required

No description available.

workflows array Required

The workflows in .knotless/workflows on the default branch, by name.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

Parameters

cursor The `cursor` of the page before.

limit

repo * The repository's dev.knotless.repo record. Its authority may be a handle; a name the repository had before, or an owner it moved from with its agreement, finds it under the name it has now.

workflow Only the runs of this workflow, by name.

View raw schema

{
  "description": "The runs of a public repository's workflows that the runners its record names reported, newest first, of every workflow or of one: each as its check, with what it ran on. And the workflows on its default branch, those that run only when asked for by name among them. A page at a time: follow `cursor` until it is absent. No authentication; responses are not personalized.",
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "cursor": {
          "description": "Absent on the last page.",
          "maxLength": 2048,
          "type": "string"
        },
        "minutes": {
          "description": "The minutes each of the repository's runners counts for its owner, where it has counted any; none for a private repository.",
          "items": {
            "ref": "dev.knotless.defs#minutesView",
            "type": "ref"
          },
          "type": "array"
        },
        "runs": {
          "items": {
            "ref": "#runView",
            "type": "ref"
          },
          "type": "array"
        },
        "workflows": {
          "description": "The workflows in .knotless/workflows on the default branch, by name.",
          "items": {
            "ref": "#workflowView",
            "type": "ref"
          },
          "type": "array"
        }
      },
      "required": [
        "runs",
        "workflows"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "cursor": {
        "description": "The `cursor` of the page before.",
        "maxLength": 2048,
        "type": "string"
      },
      "limit": {
        "default": 30,
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "repo": {
        "description": "The repository's dev.knotless.repo record. Its authority may be a handle; a name the repository had before, or an owner it moved from with its agreement, finds it under the name it has now.",
        "format": "at-uri",
        "type": "string"
      },
      "workflow": {
        "description": "Only the runs of this workflow, by name.",
        "maxLength": 64,
        "type": "string"
      }
    },
    "required": [
      "repo"
    ],
    "type": "params"
  },
  "type": "query"
}

runView object

One run of a workflow, with what it ran on.

Properties

batch integer Optional

For a run of a merge queue's batch, how many pulls it lands.

minimum: 1

check ref dev.knotless.defs#checkView Required

No description available.

pull ref dev.knotless.defs#itemViewBasic Optional

For a run of a pull's head, the pull.

ref string Required

The ref it ran at, in full: for a pull's run its head branch, for a merge queue batch's the branch it lands on.

maxLength: 1024 bytes

subject string Optional

For a run of a commit pushed to the ref, the first line of its message, where this server has the commit.

View raw schema

{
  "description": "One run of a workflow, with what it ran on.",
  "properties": {
    "batch": {
      "description": "For a run of a merge queue's batch, how many pulls it lands.",
      "minimum": 1,
      "type": "integer"
    },
    "check": {
      "ref": "dev.knotless.defs#checkView",
      "type": "ref"
    },
    "pull": {
      "description": "For a run of a pull's head, the pull.",
      "ref": "dev.knotless.defs#itemViewBasic",
      "type": "ref"
    },
    "ref": {
      "description": "The ref it ran at, in full: for a pull's run its head branch, for a merge queue batch's the branch it lands on.",
      "maxLength": 1024,
      "type": "string"
    },
    "subject": {
      "description": "For a run of a commit pushed to the ref, the first line of its message, where this server has the commit.",
      "type": "string"
    }
  },
  "required": [
    "check",
    "ref"
  ],
  "type": "object"
}

workflowView object

A workflow file on the default branch.

Properties

about string Optional

The first sentence of the comment its file opens with.

asked boolean Optional

Whether it runs only when asked for by name, on no push or pull.

name string Required

No description available.

maxLength: 64 bytes

View raw schema

{
  "description": "A workflow file on the default branch.",
  "properties": {
    "about": {
      "description": "The first sentence of the comment its file opens with.",
      "type": "string"
    },
    "asked": {
      "default": false,
      "description": "Whether it runs only when asked for by name, on no push or pull.",
      "type": "boolean"
    },
    "name": {
      "maxLength": 64,
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}