Reset Paragraph Contents (Dev Only)
Resets one content kind across every paragraph in a note atomically.
This endpoint is available only when content editing is enabled in the
environment. It is being tested in dev and is not available in production.
Requires note:write and permission to edit the note.
original resets plain and speaker-attributed transcripts, including
speaker assignments. It preserves translations and paragraph summaries.
translated resets only translations. summary resets only paragraph
summaries. Note summaries and documents are separate resources and remain unchanged.
Read GET /v1/external/notes/{noteGuid}/paragraphs from the same dev base
URL, https://api.tiro-ooo.dev. Production reads omit editState.
Copy editState.etag and check
editState.canResetByKind for the selected kind. The availability map
applies to the entire note, even though it appears on each paragraph.
Previous Undo history ends for the reset content. Other content and its
Undo history remain available. Original reset also prevents Undo of
affected earlier speaker changes. If any target cannot be reset, no
paragraph content is changed.
The existing single-paragraph reset keeps its three-field behavior. This operation does not change that endpoint’s contract.
Authorizations
API key in format {id}.{secret}.
The notes an endpoint returns depend on the key type. A user key reaches the notes that user can see in the app, including notes in their own private folders. A system key (workspace or organization, no user identity) reaches only notes that sit in a folder shared with all workspace members. Notes in a private folder, in a folder shared with only some members, or in no folder at all fall outside a system key's read scope, and scopes do not widen that boundary.
List and search endpoints drop out-of-scope notes from the response without an
error. Single-note reads and their sub-resources return 404, the same response
as a deleted note. See What notes a system key reads.
Path Parameters
GUID of the note whose paragraphs are reset.
Body
Response
Reset completed. Returns the new etag with undoAvailable and canReset set to false for this command target. Read the paragraphs again for updated content and availability for other actions.