Forgejo API
GET/admin/actions/runners

List all Action runners

Lists all Action runners, including global runners and runners scoped to an organization, user, or repository. Use visible to include all visible runners or restrict results to runners directly owned by the instance, and use page and limit to control pagination. Each result includes runner identity, ownership, labels, status, and version details.

3 parameters
visiblebooleanoptional
Whether to include all visible runners (`true`) or only runners directly owned by the instance (`false`).
pageintegeroptional
The one-based page number of results to return.
limitintegeroptional
The number of runners to include in each result page.

3 status codes
200Returns an array of Action runner objects with identifiers, names, descriptions, ownership IDs, labels, status, UUID, ephemeral state, and reported version.
descriptionstringoptional
Description provides optional details about this runner.
ephemeralbooleanoptional
Indicates if runner is ephemeral runner
idintegeroptional
ID uniquely identifies this runner.
labelsarray<string>optional
Labels is a list of labels attached to this runner.
namestringoptional
Name of the runner; not unique.
owner_idintegeroptional
OwnerID is the identifier of the user or organization this runner belongs to. O if the runner is owned by a repository.
repo_idintegeroptional
RepoID is the identifier of the repository this runner belongs to. 0 if the runner belongs to a user or organization.
statusstringoptional
Status indicates whether this runner is offline, or active, for example.
Allowed:offlineidleactive
uuidstringoptional
UUID uniquely identifies this runner.
versionstringoptional
Version is the self-reported version string of Forgejo Runner.
400Returned when a query parameter has an invalid value or cannot be parsed according to its declared type.
messagestringoptional
urlstringoptional
404Returned when the requested runner listing resource cannot be found.
errorsarray<string>optional
messagestringoptional
urlstringoptional

Error handling

A 400 is returned when page, limit, or visible cannot be parsed according to its declared type. A 404 is returned when the requested runner listing resource cannot be found. page is one-based when supplied.