GET/orgs/{org}/actions/runners/deprecations/{version}

Get runner version end-of-life schedule for an organization

Gets the end-of-life schedule for a specific runner version in an organization. Returns the runner version and the dates when registration and runtime support will end.

Authenticated users must have admin access to the organization to use this endpoint.

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters

orgstringrequired

The organization name. The name is not case sensitive.

versionstringrequired

The runner version to look up.

1 status code

200Response

runner_versionstringrequired

The runner version string.

registration_deprecates_atstringoptional

The date after which this runner version can no longer register. Null if no schedule is set.

runtime_deprecates_atstringoptional

The date after which jobs will no longer be dispatched to runners on this version.

import { Client } from "acme-sdk";

const client = new Client({
  baseUrl: "https://api.acme.com",
  auth: { bearer: process.env.API_TOKEN },
  retry: {
    maxAttempts: 3,
    retryOn: [
      408,
      425,
      429,
      500,
      502,
      503,
      504,
    ],
    backoffMs: 500,
    maxBackoffMs: 8000,
  },
  timeoutMs: 30000,
});

const result = await client.deprecations.get({
  org: "acme-inc",
  version: "example",
});

{
  "runner_version": "2.300.0",
  "runtime_deprecates_at": "2026-09-01T00:00:00Z"
}