File versions
Every save keeps the copy it replaced. Versions are per file, are capped, and count against stored bytes.
Save as a new file
Saves the current content as a separate file rather than as a version of this one, leaving the original where it is.
Requires any one of media:edit, document:edit, knowledge-base:write, thread:edit, design:edit, prompt:edit, presentation:edit or task:form:edit.
path Parameters
idHeaders
X-Tenant-IdThe workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.
Save as a new file › Responses
Success
List versions
Returns the copies earlier saves replaced, newest first. Versions count against stored bytes and are capped per file.
Requires any one of media:view, document:view, knowledge-base:view, thread:view, design:view, prompt:view or presentation:view.
path Parameters
idHeaders
X-Tenant-IdThe workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.
List versions › Responses
Success
fv_idfv_createdfv_masterfv_reasonfv_sizefv_typefv_hashfv_replicasfv_metadatafv_added_byfv_namefv_added_by_nameSave as a new version
Takes bytes already uploaded as a throw-away file and attaches them to this file as its newest version, in one step, removing the temporary file. This is how an editor saves without leaving a stray upload behind.
Requires any one of media:edit, document:edit, knowledge-base:write, thread:edit, design:edit, prompt:edit, presentation:edit or task:form:edit.
path Parameters
idquery Parameters
takeOwnershipHeaders
X-Tenant-IdThe workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.
Save as a new version › Responses
Success
Delete a version
Versions count against the storage quota, so pruning them frees space.
Requires any one of media:edit, document:edit, knowledge-base:write, thread:edit, design:edit, prompt:edit, presentation:edit or task:form:edit.
path Parameters
idversion_idHeaders
X-Tenant-IdThe workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.
Delete a version › Responses
Success. No content.
Revert to a version
Swaps the current content with the chosen version rather than discarding what was there — the version you were on becomes a version itself, so a revert is undoable.
Requires any one of media:edit, document:edit, knowledge-base:write, thread:edit, design:edit, prompt:edit, presentation:edit or task:form:edit.
path Parameters
idversion_idHeaders
X-Tenant-IdThe workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.
Revert to a version › Responses
Success