---
updatedAt: 2025-11-10T23:54:11.000Z
agentTools:
  projectIndex: https://orka.readme.io/llms.txt
---

# Add image to cache on specified node(s)

The status code for each node the image is being cached on is returned.
202 is returned when the caching is started on the node.
500 is returned along with the error if the caching job cannot start on the node.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "description": "An API Server that serves as an efficient gateway for managing VMs, Nodes, Images, and more within Orka clusters.",
    "title": "Orka API Server",
    "contact": {},
    "version": "3.5.0"
  },
  "paths": {
    "/api/v1/namespaces/{namespace}/cache/images": {
      "post": {
        "security": [
          {
            "BearerTokenAuth": []
          }
        ],
        "description": "The status code for each node the image is being cached on is returned.\n202 is returned when the caching is started on the node.\n500 is returned along with the error if the caching job cannot start on the node.",
        "tags": [
          "Image Cache"
        ],
        "summary": "Add image to cache on specified node(s)",
        "operationId": "addImageToCache",
        "parameters": [
          {
            "description": "namespace",
            "name": "namespace",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/v1.OrkaAddImageToCacheRequestModel"
              }
            }
          },
          "description": "body",
          "required": true
        },
        "responses": {
          "207": {
            "description": "Multi-Status",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/api.ItemsResponse-v1_OrkaAddImageToCacheResponseModel"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerTokenAuth": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header"
      }
    },
    "schemas": {
      "api.ItemsResponse-v1_OrkaAddImageToCacheResponseModel": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1.OrkaAddImageToCacheResponseModel"
            }
          }
        }
      },
      "v1.OrkaAddImageToCacheRequestModel": {
        "type": "object",
        "required": [
          "image"
        ],
        "properties": {
          "all": {
            "type": "boolean"
          },
          "image": {
            "type": "string",
            "example": "sonoma-90gb-orka3-arm"
          },
          "nodes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "v1.OrkaAddImageToCacheResponseModel": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string"
          },
          "nodeName": {
            "type": "string"
          },
          "status": {
            "type": "integer"
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```