ContentUpdate

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/ContentUpdate",
  "title": "ContentUpdate",
  "required": [
    "type",
    "version"
  ],
  "type": "object",
  "additionalProperties": true,
  "properties": {
    "version": {
      "nullable": true,
      "required": [
        "number"
      ],
      "type": "object",
      "additionalProperties": true,
      "properties": {
        "number": {
          "type": "integer",
          "description": "The version number.",
          "format": "int32"
        },
        "message": {
          "type": "string",
          "description": "An optional message to be stored with the corresponding version.",
          "nullable": true
        }
      },
      "description": "The new version for the updated content. Set this to the current version number incremented by one, unless you are changing the status to 'draft' which must have a version number of 1.\n\nTo get the current version number, use [Get content by ID](#api-content-id-get) and retrieve `version.number`.",
      "example": "example_value"
    },
    "title": {
      "nullable": true,
      "maxLength": 255,
      "type": "string",
      "description": "The updated title of the content. If you are updating a non-draft `page` or `blogpost`, title is required. If you are not changing the title, set this field to the the current title.",
      "example": "Example Title"
    },
    "type": {
      "nullable": true,
      "type": "string",
      "description": "The type of content. Set this to the current type of the content. For example, - page - blogpost - comment - attachment",
      "example": "example_value"
    },
    "status": {
      "type": "string",
      "description": "The updated status of the content. Note, if you change the status of a page from\n'current' to 'draft' and it has an existing draft, the existing draft will be deleted\nin favor of the updated page.",
      "enum": [
        "current",
        "trashed",
        "deleted",
        "historical",
        "draft"
      ],
      "example": "current"
    },
    "ancestors": {
      "nullable": true,
      "type": "array",
      "description": "The new parent for the content. Only one parent content 'id' can be specified.",
      "items": {
        "required": [
          "id"
        ],
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "id": {
            "oneOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ],
            "description": "The `id` of the parent content."
          }
        }
      },
      "example": []
    },
    "body": {
      "type": "object",
      "properties": {
        "view": {
          "$ref": "#/components/schemas/ContentBodyCreate"
        },
        "export_view": {
          "$ref": "#/components/schemas/ContentBodyCreate"
        },
        "styled_view": {
          "$ref": "#/components/schemas/ContentBodyCreate"
        },
        "storage": {
          "$ref": "#/components/schemas/ContentBodyCreateStorage"
        },
        "editor": {
          "$ref": "#/components/schemas/ContentBodyCreate"
        },
        "editor2": {
          "$ref": "#/components/schemas/ContentBodyCreate"
        },
        "wiki": {
          "$ref": "#/components/schemas/ContentBodyCreate"
        },
        "atlas_doc_format": {
          "$ref": "#/components/schemas/ContentBodyCreate"
        },
        "anonymous_export_view": {
          "$ref": "#/components/schemas/ContentBodyCreate"
        }
      },
      "description": "The updated body of the content. Does not apply to attachments.\nIf you are not sure how to generate these formats, you can create a page in the\nConfluence application, retrieve the content using [Get content](#api-content-get),\nand expand the desired content format, e.g. `expand=body.storage`.",
      "example": "example_value"
    }
  }
}