This API v3 documentation is currently still on progress. For any issue, please contact support@runcloud.io

Get Patch Details with Eligible Servers

GET

/settings/patches/{patch}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Header Params

Body Params application/json

Example

{}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://manage.runcloud.io/api/v3/settings/patches/?page=undefined&per_page=undefined&search=undefined' \
--header 'accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
  "patch": {
    "id": 1,
    "label": "Security Patch #1",
    "description": "Fixes CVE-2024-1234",
    "requires_reboot": true,
    "released_at": "2026-06-11T10:00:00.000000Z",
    "server_criteria": {
      "os_versions": ["Ubuntu 22.04 (Jammy)", "Ubuntu 24.04 (Noble)"],
      "web_server": ["NGINX"],
      "architecture": ["x86_64"],
      "installation_type": ["Native"],
      "database_type": ["MySQL"]
    }
  },
  "servers": [
    {
      "id": 123,
      "name": "my-server",
      "ip_address": "1.2.3.4",
      "online": true,
      "patch_status": "not_applied",
      "error_message": null,
      "started_at": null,
      "completed_at": null
    }
  ],
  "meta": {
    "pagination": {
      "total": 25,
      "count": 10,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 3,
      "links": []
    }
  },
  "summary": {
    "total": 25,
    "not_applied": 20,
    "pending": 2,
    "completed": 2,
    "failed": 1
  }
}

Modified at 2026-07-01 03:14:38

List Active Patches

Apply Patch to Servers