_wp_put_post_revision( int|WP_Post|array|null $post = null, bool $autosave = false ): int|WP_Error

354function _wp_put_post_revision( $post = null, $autosave = false ) {355	if ( is_object( $post ) ) {356		$post = get_object_vars( $post );357	} elseif ( ! is_array( $post ) ) {358		$post = get_post( $post, ARRAY_A );359	}360 361	if ( ! $post || empty( $post['ID'] ) ) {362		return new WP_Error( 'invalid_post', __( 'Invalid post ID.' ) );363	}364 365	if ( isset( $post['post_type'] ) && 'revision' === $post['post_type'] ) {366		return new WP_Error( 'post_type', __( 'Cannot create a revision of a revision' ) );367	}368 369	$post = _wp_post_revision_data( $post, $autosave );370	$post = wp_slash( $post ); // Since data is from DB.371 372	$revision_id = wp_insert_post( $post, true );373	if ( is_wp_error( $revision_id ) ) {374		return $revision_id;375	}376 377	if ( $revision_id ) {378		/**379		 * Fires once a revision has been saved.380		 *381		 * @since 2.6.0382		 * @since 6.4.0 The post_id parameter was added.383		 *384		 * @param int $revision_id Post revision ID.385		 * @param int $post_id     Post ID.386		 */387		do_action( '_wp_put_post_revision', $revision_id, $post['post_parent'] );388	}389 390	return $revision_id;391}