Skip to content
Try Gitea Cloud ☁️ for 30 days → Accelerate your Development & Deploys!
GiteaGitea Documentation
This is the documentation of the next version, still under development. See the latest release.

Get org-level runners

GET
/orgs/{org}/actions/runners
curl --request GET \
  --url https://gitea.com/api/v1/orgs/example/actions/runners \
  --header 'Authorization: Basic <credentials>'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
org
required
string

Name of the organization

Query Parameters

Section titled “Query Parameters”
disabled
boolean

Filter by disabled status (true or false)

Responses

Section titled “Responses”

200

Section titled “200”

RunnerList

Media typeapplication/json

ActionRunnersResponse returns Runners

object
runners
Array<object>

ActionRunner represents a Runner

object
busy
boolean
disabled
boolean
ephemeral
boolean
id
integer format: int64
labels
Array<object>

ActionRunnerLabel represents a Runner Label

object
id
integer format: int64
name
string
type
string
name
string
status
string
total_count
integer format: int64
Examplegenerated
{
  "runners": [
    {
      "busy": true,
      "disabled": true,
      "ephemeral": true,
      "id": 1,
      "labels": [
        {
          "id": 1,
          "name": "example",
          "type": "example"
        }
      ],
      "name": "example",
      "status": "example"
    }
  ],
  "total_count": 1
}

400

Section titled “400”

APIError is error format response

Headers

Section titled “Headers”
message
string
url
string

404

Section titled “404”

APINotFound is a not found empty response