updateSpecFile

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/postman/main/json-schema/postman-update-spec-file-schema.json",
  "title": "updateSpecFile",
  "description": "You must pass one of the accepted values in this request body. Also, this request body does not accept multiple properties in a single call. For example, you cannot pass both the `content` and `type` property at the same time.",
  "x-generated": "2026-10-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/postman-specs-api-openapi.yml#/components/schemas/updateSpecFile",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The file's name."
    },
    "type": {
      "$ref": "#/$defs/UpdateSpecFileType",
      "description": "The type of file:\n- `ROOT` — The file containing the full OpenAPI structure. This serves as the entry point for the API spec and references other (`DEFAULT`) spec files. Multi-file specs can only have one root file.\n- `DEFAULT` — A file referenced by the `ROOT` file.\n"
    },
    "content": {
      "type": "string",
      "description": "The specification's stringified contents."
    }
  },
  "$defs": {
    "UpdateSpecFileType": {
      "type": "string",
      "enum": [
        "DEFAULT",
        "ROOT"
      ],
      "description": "The type of file:\n- `ROOT` — The file containing the full OpenAPI structure. This serves as the entry point for the API spec and references other (`DEFAULT`) spec files. Multi-file specs can only have one root file.\n- `DEFAULT` — A file referenced by the `ROOT` file.\n",
      "title": "UpdateSpecFileType"
    }
  }
}