segment_insert_tool
Insert a podcast library segment at the start, end, or a specific timeline second; later clips and edits shift automatically, and dry-run previews duration and movement before applying.
Instructions
Insert a library segment into an episode at start, end or a timeline second.
at is the text start or end (any case) or a number of seconds; end is read
when the edit runs, under the document lock.
Later clips, chapters, review comments and pending edits move by the segment's length
(podcast segment insert). The edit goes through the document plane as InsertSegment:
it is journaled, shows in Studio at once and is one undo step (history_undo). It is
applied, not held as a pending proposal, because a pending proposal only exists for
remove, mute and split edits. Use dry_run=true first: it reports the new duration and
what would move, and changes nothing (it also probes the segment's audio, so it refuses
what the insert would). version picks an older version; the one used is journaled.
The result carries dry_run (true or false). Errors: segment_version_invalid, segment_unknown, segment_hash_mismatch, segment_position_out_of_range,
segment_media_invalid, segment_write_failed.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"segment_id": "<segment_id>",
"at": "<at>"
},
"name": "segment_insert_tool"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | Yes | ||
| dry_run | No | ||
| version | No | ||
| segment_id | Yes | ||
| project_path | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |