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

# Delete a VM config

# 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}/vmconfigs/{vmconfig}": {
      "delete": {
        "security": [
          {
            "BearerTokenAuth": []
          }
        ],
        "tags": [
          "VM Configs"
        ],
        "summary": "Delete a VM config",
        "operationId": "deleteVmConfig",
        "parameters": [
          {
            "description": "namespace of the VirtualMachineConfig",
            "name": "namespace",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "name of the VirtualMachineConfig",
            "name": "vmconfig",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1.Status"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1.Status"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1.Status"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerTokenAuth": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header"
      }
    },
    "schemas": {
      "v1.CauseType": {
        "type": "string",
        "enum": [
          "FieldValueNotFound",
          "FieldValueRequired",
          "FieldValueDuplicate",
          "FieldValueInvalid",
          "FieldValueNotSupported",
          "UnexpectedServerResponse",
          "FieldManagerConflict",
          "ResourceVersionTooLarge"
        ],
        "x-enum-varnames": [
          "CauseTypeFieldValueNotFound",
          "CauseTypeFieldValueRequired",
          "CauseTypeFieldValueDuplicate",
          "CauseTypeFieldValueInvalid",
          "CauseTypeFieldValueNotSupported",
          "CauseTypeUnexpectedServerResponse",
          "CauseTypeFieldManagerConflict",
          "CauseTypeResourceVersionTooLarge"
        ]
      },
      "v1.ListMeta": {
        "type": "object",
        "properties": {
          "continue": {
            "description": "continue may be set if the user set a limit on the number of items returned, and indicates that\nthe server has more data available. The value is opaque and may be used to issue another request\nto the endpoint that served this list to retrieve the next set of available objects. Continuing a\nconsistent list may not be possible if the server configuration has changed or more than a few\nminutes have passed. The resourceVersion field returned when using this continue value will be\nidentical to the value in the first response, unless you have received this token from an error\nmessage.",
            "type": "string"
          },
          "remainingItemCount": {
            "description": "remainingItemCount is the number of subsequent items in the list which are not included in this\nlist response. If the list request contained label or field selectors, then the number of\nremaining items is unknown and the field will be left unset and omitted during serialization.\nIf the list is complete (either because it is not chunking or because this is the last chunk),\nthen there are no more remaining items and this field will be left unset and omitted during\nserialization.\nServers older than v1.15 do not set this field.\nThe intended use of the remainingItemCount is *estimating* the size of a collection. Clients\nshould not rely on the remainingItemCount to be set or to be exact.\n+optional",
            "type": "integer"
          },
          "resourceVersion": {
            "description": "String that identifies the server's internal version of this object that\ncan be used by clients to determine when objects have changed.\nValue must be treated as opaque by clients and passed unmodified back to the server.\nPopulated by the system.\nRead-only.\nMore info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency\n+optional",
            "type": "string"
          },
          "selfLink": {
            "description": "Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.\n+optional",
            "type": "string"
          }
        }
      },
      "v1.Status": {
        "type": "object",
        "properties": {
          "apiVersion": {
            "description": "APIVersion defines the versioned schema of this representation of an object.\nServers should convert recognized schemas to the latest internal value, and\nmay reject unrecognized values.\nMore info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources\n+optional",
            "type": "string"
          },
          "code": {
            "description": "Suggested HTTP return code for this status, 0 if not set.\n+optional",
            "type": "integer"
          },
          "details": {
            "description": "Extended data associated with the reason.  Each reason may define its\nown extended details. This field is optional and the data returned\nis not guaranteed to conform to any schema except that defined by\nthe reason type.\n+optional",
            "allOf": [
              {
                "$ref": "#/components/schemas/v1.StatusDetails"
              }
            ]
          },
          "kind": {
            "description": "Kind is a string value representing the REST resource this object represents.\nServers may infer this from the endpoint the client submits requests to.\nCannot be updated.\nIn CamelCase.\nMore info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds\n+optional",
            "type": "string"
          },
          "message": {
            "description": "A human-readable description of the status of this operation.\n+optional",
            "type": "string"
          },
          "metadata": {
            "description": "Standard list metadata.\nMore info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds\n+optional",
            "allOf": [
              {
                "$ref": "#/components/schemas/v1.ListMeta"
              }
            ]
          },
          "reason": {
            "description": "A machine-readable description of why this operation is in the\n\"Failure\" status. If this value is empty there\nis no information available. A Reason clarifies an HTTP status\ncode but does not override it.\n+optional",
            "allOf": [
              {
                "$ref": "#/components/schemas/v1.StatusReason"
              }
            ]
          },
          "status": {
            "description": "Status of the operation.\nOne of: \"Success\" or \"Failure\".\nMore info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status\n+optional",
            "type": "string"
          }
        }
      },
      "v1.StatusCause": {
        "type": "object",
        "properties": {
          "field": {
            "description": "The field of the resource that has caused this error, as named by its JSON\nserialization. May include dot and postfix notation for nested attributes.\nArrays are zero-indexed.  Fields may appear more than once in an array of\ncauses due to fields having multiple errors.\nOptional.\n\nExamples:\n  \"name\" - the field \"name\" on the current resource\n  \"items[0].name\" - the field \"name\" on the first array entry in \"items\"\n+optional",
            "type": "string"
          },
          "message": {
            "description": "A human-readable description of the cause of the error.  This field may be\npresented as-is to a reader.\n+optional",
            "type": "string"
          },
          "reason": {
            "description": "A machine-readable description of the cause of the error. If this value is\nempty there is no information available.\n+optional",
            "allOf": [
              {
                "$ref": "#/components/schemas/v1.CauseType"
              }
            ]
          }
        }
      },
      "v1.StatusDetails": {
        "type": "object",
        "properties": {
          "causes": {
            "description": "The Causes array includes more details associated with the StatusReason\nfailure. Not all StatusReasons may provide detailed causes.\n+optional",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1.StatusCause"
            }
          },
          "group": {
            "description": "The group attribute of the resource associated with the status StatusReason.\n+optional",
            "type": "string"
          },
          "kind": {
            "description": "The kind attribute of the resource associated with the status StatusReason.\nOn some operations may differ from the requested resource Kind.\nMore info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds\n+optional",
            "type": "string"
          },
          "name": {
            "description": "The name attribute of the resource associated with the status StatusReason\n(when there is a single name which can be described).\n+optional",
            "type": "string"
          },
          "retryAfterSeconds": {
            "description": "If specified, the time in seconds before the operation should be retried. Some errors may indicate\nthe client must take an alternate action - for those errors this field may indicate how long to wait\nbefore taking the alternate action.\n+optional",
            "type": "integer"
          },
          "uid": {
            "description": "UID of the resource.\n(when there is a single resource which can be described).\nMore info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids\n+optional",
            "type": "string"
          }
        }
      },
      "v1.StatusReason": {
        "type": "string",
        "enum": [
          "",
          "Unauthorized",
          "Forbidden",
          "NotFound",
          "AlreadyExists",
          "Conflict",
          "Gone",
          "Invalid",
          "ServerTimeout",
          "Timeout",
          "TooManyRequests",
          "BadRequest",
          "MethodNotAllowed",
          "NotAcceptable",
          "RequestEntityTooLarge",
          "UnsupportedMediaType",
          "InternalError",
          "Expired",
          "ServiceUnavailable"
        ],
        "x-enum-varnames": [
          "StatusReasonUnknown",
          "StatusReasonUnauthorized",
          "StatusReasonForbidden",
          "StatusReasonNotFound",
          "StatusReasonAlreadyExists",
          "StatusReasonConflict",
          "StatusReasonGone",
          "StatusReasonInvalid",
          "StatusReasonServerTimeout",
          "StatusReasonTimeout",
          "StatusReasonTooManyRequests",
          "StatusReasonBadRequest",
          "StatusReasonMethodNotAllowed",
          "StatusReasonNotAcceptable",
          "StatusReasonRequestEntityTooLarge",
          "StatusReasonUnsupportedMediaType",
          "StatusReasonInternalError",
          "StatusReasonExpired",
          "StatusReasonServiceUnavailable"
        ]
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```