Document replaces the file the item points at — this is how a report is superseded by its next edition. The new document must already exist in the caller org's own store.
Retired withdraws the item, or true→false restores it. A retired item leaves the public centre at once and can no longer be granted; grants already made over it stand, because they are part of the record.