Items

Restore an item's body to an earlier version

Restore one item's or expert's body to an earlier version from list_versions (its cells too, where the snapshot kept them). The current body is snapshotted first, so a restore is itself undoable. When the person, or a collaborator, edited the body in Roma after that version, the call answers needsConfirmation and names those later edits instead of restoring; the same call with acceptLaterEdits: true, after the person agreed to lose them, restores. Writes made over this connection never ask: undoing them is what the tool is for.

post/api/v1/items/{id}/versions/{versionId}/restore

Request

  • Base URL
    https://api.roma.app
  • URL
    https://api.roma.app/api/v1/items/{id}/versions/{versionId}/restore
  • Auth
    HTTP bearer

Path parameters

idstring required

The item's or the expert's id.

versionIdstring required

The version to restore, from list_versions.

Request body

acceptLaterEditsboolean nullable

true only after the person said yes to losing the edits made in Roma after that version, the ones the needsConfirmation answer named. Omit on the first call.

Response

The tool's result.

restoredboolean
idstring
titlestring nullable
needsConfirmationboolean
hintstring

Changes

No recorded changes to this operation across all 1 revision of this API.