{ "$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" } } }