list_template_targets
List every editable target in a template—paragraphs, runs, cells, tables, images—with IDs and character constraints to construct accurate edit lists before filling and saving.
Instructions
List every editable target in the template (paragraphs, runs, cells, tables, images) so the chatbot can build a precise edit list.
USE WHEN: Canonical first call before fill_and_save. You need target_ids
text_hashes to construct edits, and char_count / display_width / max_recommended_chars to keep generated content within container limits. DO NOT USE WHEN: You only need a human-readable overview — use inspect_template instead.
Provide the template either as template_path or as template_b64 +
template_filename. Filter with target_kinds (any subset of
{paragraph, run, cell, table, image}); leave None for all kinds.
Paginate via start + limit; next_start is non-None when more
targets remain. (max_targets is a deprecated alias for limit.)
Each target carries (where applicable):
target_id, target_kind, current_text, text_hash
char_count (code points), display_width (EAW-aware), max_recommended_chars
page_number
parent_paragraph_id / parent_table_id — the container
row_index / column_index / rowspan / colspan — for cells
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| template_path | No | ||
| template_b64 | No | ||
| template_filename | No | ||
| target_kinds | No | ||
| start | No | ||
| limit | No | ||
| max_targets | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||