From 8763566ccf1724e5f888eec730fdd9b00918f1fb Mon Sep 17 00:00:00 2001 From: Sava Znatnov Date: Sun, 11 Oct 2026 02:32:44 +0700 Subject: [PATCH] feat(mcp): every tool that writes takes `dry_run` and answers the request it would send A tool that writes, called with `dry_run: true`, sends nothing and answers `{"dry_run": true, "request": {method, url, body}}`: the object the command prints under `--dry-run -o json`, with secrets masked by the same function (#556). What the tool reads before its first write is read; the plan is of the first write. `request` is null where the tool would write nothing. A plan that would grant access says `grants_access: true`. One place does it for all 260 tools, and no tool declares the argument: a middleware of every ycli server takes `dry_run` out of the call and answers the write the core's guard stopped; `client_provider`, the one place a tool's client is built, builds it with that guard; a listing transform adds the argument to every tool whose `readOnlyHint` is false and puts the plan beside the tool's own answer in its output schema. `dry_run` written inside an argument (in a body that takes any key, or spelled `dryRun`, `dry-run`) is refused before anything is sent: one who nests it believes they are planning. A plan is no error: nothing in the log says a tool failed, and no traceback of the signal is written. A tool that only reads has no `dry_run` and refuses it like any argument it does not have. A tool that grants access prompts for a person on a dry run too: the client decides from the tool's entry, before the server sees the arguments. ARCH-3 states the rule. Held by: the contract check that for every write case the tool's plan is the command's plan and neither sends a write; a check that every writing tool takes its client from the one guarded place; tests that calls side by side do not take each other's flag and that the flag is gone after a call that failed; a check that a secret given to a tool is not in its plan, by its literal value. Co-Authored-By: Claude Opus 5.5 --- .agents/skills/yandex-360/SKILL.md | 3 +- .claude/skills/yandex-360/SKILL.md | 3 +- .opencode/skills/yandex-360/SKILL.md | 3 +- ARCHITECTURE.md | 8 +- docs/en/how-to/serve-the-mcp-server.md | 17 + docs/en/reference/mcp/datalens.md | 74 +++ docs/en/reference/mcp/forms.md | 45 ++ docs/en/reference/mcp/tracker.md | 107 ++++ docs/en/reference/mcp/wiki.md | 37 ++ docs/ru/how-to/serve-the-mcp-server.md | 18 + plugins/yandex-360/skills/yandex-360/SKILL.md | 3 +- src/ycli/mcp/server.py | 4 + src/ycli/yandex/mcp.py | 201 ++++++- tests/architecture/test_conventions.py | 7 +- tests/contract/test_contract.py | 39 ++ tests/snapshots/mcp_output_schemas.txt | 520 +++++++++--------- tests/snapshots/mcp_signatures.txt | 520 +++++++++--------- tests/unit/mcp/test_dry_run.py | 455 +++++++++++++++ 18 files changed, 1534 insertions(+), 530 deletions(-) create mode 100644 tests/unit/mcp/test_dry_run.py diff --git a/.agents/skills/yandex-360/SKILL.md b/.agents/skills/yandex-360/SKILL.md index 52b153d6..d7eb2f7b 100644 --- a/.agents/skills/yandex-360/SKILL.md +++ b/.agents/skills/yandex-360/SKILL.md @@ -120,7 +120,8 @@ semantics, a service ycli does not wrap yet), read the official docs directly, a session must not write at all, run the server with `ycli mcp start --read-only`. - **CLI deletes and grants ask first** — a command that deletes data or grants access prompts on a terminal and, without one (an agent's shell), exits 2 unless given `--yes`; confirm intent with the user before - adding it. `--dry-run` prints the write request instead of sending it, the JSON result pipes + adding it. `--dry-run` prints the write request instead of sending it (a write tool takes + `dry_run: true` for the same plan), the JSON result pipes to `jq`, and the exit code says what failed (3 not found, 4 auth, 5 rate limited, 6 transient). - **A long listing comes in pieces** — a list tool returns `{items, truncated, next}`, 50 diff --git a/.claude/skills/yandex-360/SKILL.md b/.claude/skills/yandex-360/SKILL.md index c89fbc46..e939efd4 100644 --- a/.claude/skills/yandex-360/SKILL.md +++ b/.claude/skills/yandex-360/SKILL.md @@ -122,7 +122,8 @@ semantics, a service ycli does not wrap yet), read the official docs directly, a session must not write at all, run the server with `ycli mcp start --read-only`. - **CLI deletes and grants ask first** — a command that deletes data or grants access prompts on a terminal and, without one (an agent's shell), exits 2 unless given `--yes`; confirm intent with the user before - adding it. `--dry-run` prints the write request instead of sending it, the JSON result pipes + adding it. `--dry-run` prints the write request instead of sending it (a write tool takes + `dry_run: true` for the same plan), the JSON result pipes to `jq`, and the exit code says what failed (3 not found, 4 auth, 5 rate limited, 6 transient). - **A long listing comes in pieces** — a list tool returns `{items, truncated, next}`, 50 diff --git a/.opencode/skills/yandex-360/SKILL.md b/.opencode/skills/yandex-360/SKILL.md index c89fbc46..e939efd4 100644 --- a/.opencode/skills/yandex-360/SKILL.md +++ b/.opencode/skills/yandex-360/SKILL.md @@ -122,7 +122,8 @@ semantics, a service ycli does not wrap yet), read the official docs directly, a session must not write at all, run the server with `ycli mcp start --read-only`. - **CLI deletes and grants ask first** — a command that deletes data or grants access prompts on a terminal and, without one (an agent's shell), exits 2 unless given `--yes`; confirm intent with the user before - adding it. `--dry-run` prints the write request instead of sending it, the JSON result pipes + adding it. `--dry-run` prints the write request instead of sending it (a write tool takes + `dry_run: true` for the same plan), the JSON result pipes to `jq`, and the exit code says what failed (3 not found, 4 auth, 5 rate limited, 6 transient). - **A long listing comes in pieces** — a list tool returns `{items, truncated, next}`, 50 diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index abb1c5f1..c69d98ce 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -148,13 +148,19 @@ program stays a test. the CLI asks before it sends it, as before a delete, and the tool carries `_meta["anthropic/requiresUserInteraction"]` (`GRANTS_ACCESS`), which a client that honours it answers by asking a person on every call. No list of such operations exists anywhere. + A tool that writes takes `dry_run` and then sends nothing: the one way a tool reaches a + service is the client `client_provider` builds for it, which under `dry_run` carries the + core's guard, so no tool has a second way to a service and none declares the argument. - **Why:** agents and their hosts decide what to auto-approve from these hints; the MCP default for an unannotated tool is "destructive". - **Check:** the contract test (`tests/contract/test_contract.py`, one case per way of reaching an operation, fail-closed both ways) runs every tool and compares its hints with the strongest effect of the endpoints it sends, and its `GRANTS_ACCESS` mark with whether one of them grants access, both ways; `test_the_help_of_a_command_says_it_grants_access_where_its_tool_is_marked` - holds the command's help to the same mark; `test_arch3_effect_overrides_are_marked` keeps + holds the command's help to the same mark; + `test_every_tool_that_writes_takes_its_client_from_the_one_guarded_place` holds every writing + tool to the provider, and the contract test runs every write case under `dry_run` on both + surfaces: the same plan, and no write sent; `test_arch3_effect_overrides_are_marked` keeps `# violation(arch-3): ` above every `effect=`, and every such marker above one; `test_arch3_write_tools_carry_write_tag` keeps `--read-only` complete over the served tools, and the ast-grep rule `no-tool-tags` keeps a second statement out. `status_get`, the one diff --git a/docs/en/how-to/serve-the-mcp-server.md b/docs/en/how-to/serve-the-mcp-server.md index 2ed0dde0..9037c90b 100644 --- a/docs/en/how-to/serve-the-mcp-server.md +++ b/docs/en/how-to/serve-the-mcp-server.md @@ -34,6 +34,23 @@ Every tool says what it does: reads carry `readOnlyHint`, writes say whether the or idempotent. A host can auto-approve reads and ask before a destructive call. `--read-only` removes every write, for a deployment where the agent must not change anything. +A tool that grants access (a role, a permission, an access binding, an embedding) is marked so +that a client which honours the mark asks a person on every call, and says so in its description. + +## Preview a write + +Every tool that writes takes `dry_run`. With `dry_run: true` it sends nothing and answers the +request it would have sent, the same object `ycli … --dry-run -o json` prints, with secrets masked: + +```json +{"dry_run": true, "request": {"method": "PATCH", "url": "https://api.tracker.yandex.net/v3/issues/DE-7", "body": {"summary": "New"}}} +``` + +- What the tool reads before its first write is read; the plan is of the first write only. One tool makes several: `wiki_attachments_upload` plans the opening of its upload session. +- `request` is `null` where the tool would write nothing. +- A tool that only reads has no `dry_run`: there is nothing to plan, and the argument is refused. The CLI differs: `--dry-run` is an option of every command, and a read under it goes out. +- A tool that grants access prompts for a person on a dry run too: the client decides from the tool, before the server sees the arguments. Where nobody can be asked, plan it with the command: `ycli … --dry-run`. + ## Prompts and resources Besides tools, the server offers a few prompts and resources. A client shows a prompt as a ready request (in Claude Code, `/yandex-360:tracker_issue_brief DE-7`) and lets you attach a resource to the conversation (`@yandex-360:ycli://tracker/issue/DE-7`). diff --git a/docs/en/reference/mcp/datalens.md b/docs/en/reference/mcp/datalens.md index 7a5d0a79..0f0b0c3e 100644 --- a/docs/en/reference/mcp/datalens.md +++ b/docs/en/reference/mcp/datalens.md @@ -100,6 +100,7 @@ Create a collection in another one, or in the root when no parent is given. | `title` | string | yes | Title of the collection. | | `parent_id` | string or null | | The collection to put it in; the root when left out. | | `description` | string or null | | Description of the collection. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_collections_update` @@ -112,6 +113,7 @@ Change a collection's title or description; what is not given stays as it is. | `collection_id` | string | yes | Collection id. | | `title` | string or null | | New title. | | `description` | string or null | | New description. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_collections_move` @@ -124,6 +126,7 @@ Move a collection into another one, or into the root when no parent is given. | `collection_id` | string | yes | Collection id. | | `parent_id` | string or null | | The collection to put it in; the root when left out. | | `title` | string or null | | New title to give it on the way. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_collections_move_bulk` @@ -138,6 +141,7 @@ moves none of them. |---|---|:---:|---| | `collection_ids` | array of string | yes | Collection ids. | | `parent_id` | string or null | | The collection to put it in; the root when left out. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_collections_delete` @@ -148,6 +152,7 @@ Delete a collection with everything it holds: nested collections, workbooks, ent | Parameter | Type | Required | Description | |---|---|:---:|---| | `collection_id` | string | yes | Collection id. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_collections_delete_bulk` @@ -158,6 +163,7 @@ Delete several collections with everything they hold. | Parameter | Type | Required | Description | |---|---|:---:|---| | `collection_ids` | array of string | yes | Collection ids. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_collections_access_bindings_update` @@ -171,6 +177,7 @@ Grants access: a client that honours the mark asks a person on every call. |---|---|:---:|---| | `collection_id` | string | yes | Collection id. | | `deltas` | array of object | yes | The roles to add (`ADD`) and remove. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_workbooks_get` @@ -261,6 +268,7 @@ Create a workbook in a collection, or in the root when no collection is given. | `title` | string | yes | Title of the workbook. | | `collection_id` | string or null | | The collection to put the workbook in; the root when left out. | | `description` | string or null | | Description of the workbook. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_workbooks_update` @@ -273,6 +281,7 @@ Change a workbook's title or description; what is not given stays as it is. | `workbook_id` | string | yes | Workbook id. | | `title` | string or null | | New title. | | `description` | string or null | | New description. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_workbooks_move` @@ -285,6 +294,7 @@ Move a workbook into a collection, or into the root when no collection is given. | `workbook_id` | string | yes | Workbook id. | | `collection_id` | string or null | | The collection to put the workbook in; the root when left out. | | `title` | string or null | | New title to give it on the way. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_workbooks_move_bulk` @@ -299,6 +309,7 @@ moves none of them. |---|---|:---:|---| | `workbook_ids` | array of string | yes | Workbook ids. | | `collection_id` | string or null | | The collection to put the workbook in; the root when left out. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_workbooks_delete` @@ -312,6 +323,7 @@ read the workbook before deleting it again. | Parameter | Type | Required | Description | |---|---|:---:|---| | `workbook_id` | string | yes | Workbook id. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_workbooks_delete_bulk` @@ -322,6 +334,7 @@ Delete several workbooks with everything they hold. | Parameter | Type | Required | Description | |---|---|:---:|---| | `workbook_ids` | array of string | yes | Workbook ids. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_workbooks_access_bindings_update` @@ -335,6 +348,7 @@ Grants access: a client that honours the mark asks a person on every call. |---|---|:---:|---| | `workbook_id` | string | yes | Workbook id. | | `deltas` | array of object | yes | The roles to add (`ADD`) and remove. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_entrylocks_create` @@ -350,6 +364,7 @@ and until when. |---|---|:---:|---| | `entry_id` | string | yes | Entry id. | | `data` | object | yes | How long to hold the lock, in milliseconds. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_entrylocks_extend` @@ -361,6 +376,7 @@ Hold a lock longer; the reply says when it expires now. |---|---|:---:|---| | `entry_id` | string | yes | Entry id. | | `data` | object | yes | The token of the lock and its new terms. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_entrylocks_delete` @@ -374,6 +390,7 @@ An entry that is not locked answers 404. |---|---|:---:|---| | `entry_id` | string | yes | Entry id. | | `params` | object | yes | The token of the lock, or `force` for another's lock. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_sparkclusters_list` @@ -420,6 +437,7 @@ API, not measured. | `config` | object | yes | The Spark version and the pools of the driver and executors. | | `description` | string or null | | A description of the cluster. | | `labels` | object or null | | Labels of the cluster. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_sparkclusters_delete` @@ -432,6 +450,7 @@ Experimental API, not measured. | Parameter | Type | Required | Description | |---|---|:---:|---| | `id` | string | yes | Spark cluster id. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_sparkclusters_start` @@ -445,6 +464,7 @@ says how the operation ended. Experimental API, not measured. | Parameter | Type | Required | Description | |---|---|:---:|---| | `cluster_id` | string | yes | Spark cluster id. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_sparkclusters_stop` @@ -457,6 +477,7 @@ Experimental API, not measured. | Parameter | Type | Required | Description | |---|---|:---:|---| | `cluster_id` | string | yes | Spark cluster id. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_sparkclusters_resource_presets_list` @@ -517,6 +538,7 @@ Creating publishes: the page is saved and published at once. A draft comes with | `key` | string or null | | The page's key, in a folder. | | `workbook_id` | string or null | | The workbook to create the page in. | | `name` | string or null | | The page's name, in a workbook. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_htmlpages_update` @@ -530,6 +552,7 @@ everyone. With ``revId``, ``save`` copies that revision as the current draft. | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object or object | yes | Either new HTML, `{entryId, content, mode}`, or a revision to make current, `{entryId, revId, mode}`: one of the two, not both. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_htmlpages_delete` @@ -540,6 +563,7 @@ Delete an HTML page. | Parameter | Type | Required | Description | |---|---|:---:|---| | `entry_id` | string | yes | Entry id. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_htmlpages_preview_url_get` @@ -658,6 +682,7 @@ Give an entry another name; its id and what refers to it stay. |---|---|:---:|---| | `entry_id` | string | yes | Entry id. | | `name` | string | yes | The new name. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_permissions_get_bulk` @@ -706,6 +731,7 @@ editable; it is made in the DataLens interface and then read like any other. | Parameter | Type | Required | Description | |---|---|:---:|---| | `connection` | object | yes | The new connection; ``type`` says which kind it is and selects its schema. Its schema is not listed here: read `ConnectionCreate` with schema_get(service="datalens", name="ConnectionCreate"), then the definitions it refers to. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_connections_update` @@ -717,6 +743,7 @@ Change the fields given of a connection; returns an acknowledgement. |---|---|:---:|---| | `connection_id` | string | yes | Connection id. | | `data` | object | yes | The fields to change, of the connection's own kind; the others stay as they are. Its schema is not listed here: read `ConnectionUpdate` with schema_get(service="datalens", name="ConnectionUpdate"), then the definitions it refers to. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_connections_delete` @@ -733,6 +760,7 @@ Restore button (measured: the entry appears there; restoring was not tried). | Parameter | Type | Required | Description | |---|---|:---:|---| | `connection_id` | string | yes | Connection id. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_datasets_get` @@ -771,6 +799,7 @@ A dataset with no source and no field is valid: create it empty, then fill it wi | `rev_id` | string or null | | The revision. | | `saved_id` | string or null | | The saved revision. | | `workbook_id` | string or null | | The workbook to create it in. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_datasets_update` @@ -787,6 +816,7 @@ The reply holds the content and the revisions; its ``id`` is ``null`` (measured) | `dataset_id` | string | yes | Dataset id. | | `data` | object | yes | The content to save (`dataset`) and how (`mode`: `save` or `publish`). Its schema is not listed here: read `DatasetUpdate` with schema_get(service="datalens", name="DatasetUpdate"), then the definitions it refers to. | | `workbook_id` | string or null | | The workbook the dataset lies in. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_datasets_delete` @@ -802,6 +832,7 @@ Restore button (measured: the entry appears there; restoring was not tried). | Parameter | Type | Required | Description | |---|---|:---:|---| | `dataset_id` | string | yes | Dataset id. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_datasets_validate` @@ -891,6 +922,7 @@ The ``entry.data`` of a chart read with ``charts_wizard_get`` is a valid ``data` | `key` | string or null | | The entry's key, in a folder. | | `workbook_id` | string or null | | The workbook to create it in. | | `name` | string or null | | The chart's name. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_charts_wizard_update` @@ -908,6 +940,7 @@ DataLens does not check a revision here: a save overwrites what was saved since | `data` | object | yes | What the chart holds; it replaces the whole of it. Its schema is not listed here: read `WizardChartData` with schema_get(service="datalens", name="WizardChartData"), then the definitions it refers to. | | `annotation` | object or null | | A description of the chart. | | `rev_id` | string or null | | The revision the change is made on; DataLens does not check it (measured). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_charts_wizard_delete` @@ -924,6 +957,7 @@ Restore button (measured: the entry appears there; restoring was not tried). | Parameter | Type | Required | Description | |---|---|:---:|---| | `chart_id` | string | yes | Chart id. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_charts_ql_get` @@ -957,6 +991,7 @@ The specification describes neither the content of a QL chart nor the reply. | `key` | string or null | | The entry's key, in a folder. | | `workbook_id` | string or null | | The workbook to create it in. | | `name` | string or null | | The chart's name. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_charts_ql_update` @@ -974,6 +1009,7 @@ DataLens does not check a revision here: a save overwrites what was saved since | `mode` | `save` · `publish` or string | yes | `save` keeps a draft; `publish` makes it the version shown. | | `data` | object | yes | What the chart holds; it replaces the whole of it. | | `annotation` | object or null | | A description of the chart. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_charts_ql_delete` @@ -984,6 +1020,7 @@ Delete a chart; the dashboards that show it lose it. | Parameter | Type | Required | Description | |---|---|:---:|---| | `chart_id` | string | yes | Chart id. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_charts_editor_get` @@ -1010,6 +1047,7 @@ Create a chart of the editor and return it with its id. | Parameter | Type | Required | Description | |---|---|:---:|---| | `entry` | object or object or object or object or object or object | yes | The new chart: where it lies, its kind (`type`) and its code. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_charts_editor_update` @@ -1024,6 +1062,7 @@ DataLens does not check a revision here: a save overwrites what was saved since |---|---|:---:|---| | `entry` | object or object or object or object or object or object | yes | The chart to save: its `entryId`, its kind (`type`) and its code. | | `mode` | `save` · `publish` or string | yes | `save` keeps a draft; `publish` makes it the version shown. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_charts_editor_delete` @@ -1034,6 +1073,7 @@ Delete a chart; the dashboards that show it lose it. | Parameter | Type | Required | Description | |---|---|:---:|---| | `chart_id` | string | yes | Chart id. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_dashboards_get` @@ -1068,6 +1108,7 @@ Create a dashboard and return it with its id. | Parameter | Type | Required | Description | |---|---|:---:|---| | `entry` | object | yes | The new dashboard: where it lies (`workbookId`, `name`), `data` and `meta`. Its schema is not listed here: read `DashboardCreate` with schema_get(service="datalens", name="DashboardCreate"), then the definitions it refers to. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_dashboards_update` @@ -1083,6 +1124,7 @@ DataLens does not check a revision here: a save overwrites what was saved since | `entry` | object | yes | The dashboard to save: its `entryId`, `data`, `meta` and `revId`. Its schema is not listed here: read `DashboardUpdate` with schema_get(service="datalens", name="DashboardUpdate"), then the definitions it refers to. | | `mode` | `save` · `publish` or string | yes | `save` keeps the dashboard as a draft; `publish` shows it to all. | | `lock_token` | string or null | | The token of the lock held on the dashboard, when it is locked. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_dashboards_delete` @@ -1094,6 +1136,7 @@ Delete a dashboard. |---|---|:---:|---| | `dashboard_id` | string | yes | Dashboard id. | | `lock_token` | string or null | | The token of the lock held on the dashboard, when it is locked. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_reports_get` @@ -1132,6 +1175,7 @@ refuses a report with no slide: ``data.slides`` holds at least one. | `key` | string or null | | The report's key, in a folder. | | `workbook_id` | string or null | | The workbook to create the report in. | | `name` | string or null | | The report's name. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_reports_update` @@ -1154,6 +1198,7 @@ read it, change ``data``, send it back whole. | `meta` | object or null or null | yes | Metadata of the entry; null for none. Required. | | `rev_id` | string or null | | The revision of the report the change is made on. | | `annotation` | object or null | | A description of the report. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_reports_delete` @@ -1164,6 +1209,7 @@ Delete a report. | Parameter | Type | Required | Description | |---|---|:---:|---| | `entry_id` | string | yes | Report id. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_workbookexports_start` @@ -1177,6 +1223,7 @@ The export runs on its own: ask ``workbookexports_status_get`` until ``status`` | Parameter | Type | Required | Description | |---|---|:---:|---| | `workbook_id` | string | yes | Workbook id. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_workbookexports_status_get` @@ -1215,6 +1262,7 @@ An export that is over stays as it ended, and the call answers the same. | Parameter | Type | Required | Description | |---|---|:---:|---| | `export_id` | string | yes | Export id, from ``workbookexports_start``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_workbookimports_start` @@ -1233,6 +1281,7 @@ password or token again with ``connections_update``. | `title` | string | yes | The title of the new workbook. | | `collection_id` | string or null | | The collection to make it in; the root when left out. | | `description` | string or null | | The description of the new workbook. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_workbookimports_status_get` @@ -1276,6 +1325,7 @@ Grants access: a client that honours the mark asks a person on every call. | `deps_ids` | array of string or null | | The entries the embedded one depends on. | | `unsigned_params` | array of string or null | | The parameters a link may carry unsigned. | | `private_params` | array of string or null | | The parameters that go signed, inside the token. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_embeds_update` @@ -1298,6 +1348,7 @@ Grants access: a client that honours the mark asks a person on every call. | `deps_ids` | array of string or null | | The entries the embedded one depends on. | | `unsigned_params` | array of string or null | | The parameters a link may carry unsigned. | | `private_params` | array of string or null | | The parameters that go signed, inside the token. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_embeds_delete` @@ -1308,6 +1359,7 @@ Delete an embed; its links stop working. Deleting again answers 404. | Parameter | Type | Required | Description | |---|---|:---:|---| | `embed_id` | string | yes | Embed id, from ``embeds_list``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_embeddingsecrets_get` @@ -1345,6 +1397,7 @@ Grants access: a client that honours the mark asks a person on every call. |---|---|:---:|---| | `title` | string | yes | The name of the key. | | `workbook_id` | string | yes | The workbook the key belongs to. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_embeddingsecrets_delete` @@ -1355,6 +1408,7 @@ Delete a key for embedding. Deleting again answers 404. | Parameter | Type | Required | Description | |---|---|:---:|---| | `embedding_secret_id` | string | yes | Id of the key for embedding. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_sharedentries_access_bindings_list` @@ -1386,6 +1440,7 @@ Grants access: a client that honours the mark asks a person on every call. |---|---|:---:|---| | `entry_id` | string | yes | Id of a shared entry: one that lies in a collection. | | `deltas` | array of object | yes | The roles to add (`ADD`) and remove. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_audit_entries_updates_list` @@ -1447,6 +1502,7 @@ organization whose SQL editor is off answers 403 ``SQL_EDITOR_NOT_ALLOWED``. | `query` | string | yes | The text of the query. | | `description` | string or null | | A description. | | `params` | array of object or object or object or null | | The parameters the text takes: a name, a type and a default each. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_sqlqueries_update` @@ -1463,6 +1519,7 @@ Experimental in the DataLens API and written from its document: not measured. | `query` | string | yes | The text of the query. | | `description` | string or null | | A description. | | `params` | array of object or object or object or null | | The parameters the text takes. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_sqlqueries_delete` @@ -1475,6 +1532,7 @@ Experimental in the DataLens API and written from its document: not measured. | Parameter | Type | Required | Description | |---|---|:---:|---| | `sql_query_id` | string | yes | SQL query id. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_sqlqueries_run` @@ -1489,6 +1547,7 @@ API and written from its document: not measured. |---|---|:---:|---| | `sql_query_id` | string | yes | SQL query id. | | `params` | object or null | | The values of the parameters, by name; one left out takes its default. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_licensing_licenses_list` @@ -1523,6 +1582,7 @@ Grants access: a client that honours the mark asks a person on every call. | Parameter | Type | Required | Description | |---|---|:---:|---| | `user_ids` | array of string | yes | The users to give a licence to. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_licensing_limit_get` @@ -1544,6 +1604,7 @@ from the DataLens document and never called: not measured. | Parameter | Type | Required | Description | |---|---|:---:|---| | `value` | integer | yes | The most licences the instance may hold. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_cloudenvironments_list` @@ -1592,6 +1653,7 @@ Experimental in the DataLens API, written from its document and never called: no | `description` | string or null | | A description. | | `security_group_ids` | array of string or null | | The security groups the environment uses. | | `storage` | object or null | | The settings of its storage bucket; no bucket when left out. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_cloudenvironments_update` @@ -1608,6 +1670,7 @@ Experimental in the DataLens API, written from its document and never called: no | `description` | string or null | | A new description; an empty one clears it. | | `security_group_ids` | array of string or null | | The security groups the environment uses. | | `storage` | object or null | | New settings of its storage bucket. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_cloudenvironments_delete` @@ -1620,6 +1683,7 @@ Experimental in the DataLens API, written from its document and never called: no | Parameter | Type | Required | Description | |---|---|:---:|---| | `id` | string | yes | Id of the cloud environment. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_cloudenvironmentstorage_bucket_objects_list` @@ -1684,6 +1748,7 @@ its document: not measured. | `path` | string | yes | The path of the object in the bucket. | | `size` | string | yes | The size of the object in bytes, as a string. | | `content_md5` | string | yes | The MD5 digest of the content: 16 bytes, base64-encoded. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_restcatalogs_list` @@ -1721,6 +1786,7 @@ API, written from its document and never called: not measured. | `bucket_settings` | object | yes | The settings of its bucket; an empty object is valid. | | `description` | string or null | | A description. | | `labels` | object or null | | Labels, a name to a value. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_lakehouseoperations_get` @@ -1784,6 +1850,7 @@ Experimental in the DataLens API, written from its document and never called: no | `labels` | object or null | | Labels, a name to a value. | | `catalogs_config` | array of object or null | | The REST catalogs to attach. | | `trino_version` | string or null | | The version of Trino; the service's own when left out. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_trinoclusters_delete` @@ -1796,6 +1863,7 @@ Experimental in the DataLens API, written from its document and never called: no | Parameter | Type | Required | Description | |---|---|:---:|---| | `id` | string | yes | Id of the Trino cluster. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_trinoclusters_start` @@ -1809,6 +1877,7 @@ API, written from its document and never called: not measured. | Parameter | Type | Required | Description | |---|---|:---:|---| | `cluster_id` | string | yes | Id of the Trino cluster. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_trinoclusters_stop` @@ -1821,6 +1890,7 @@ Experimental in the DataLens API, written from its document and never called: no | Parameter | Type | Required | Description | |---|---|:---:|---| | `cluster_id` | string | yes | Id of the Trino cluster. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_trinoclusters_catalog_create` @@ -1834,6 +1904,7 @@ Experimental in the DataLens API, written from its document and never called: no |---|---|:---:|---| | `cluster_id` | string | yes | Id of the Trino cluster. | | `catalog` | object | yes | The REST catalog to attach, by its id. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_trinoclusters_catalog_delete` @@ -1847,6 +1918,7 @@ Experimental in the DataLens API, written from its document and never called: no |---|---|:---:|---| | `cluster_id` | string | yes | Id of the Trino cluster. | | `catalog_id` | string | yes | The id of the REST catalog to detach. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_trinoclusters_resource_presets_list` @@ -1920,6 +1992,7 @@ measured. Ask the person before calling. | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object or object or object | yes | The application to make: ``clusterId``, a ``name``, the ``catalogs`` to attach, and exactly one of ``sparkApplication`` (a JAR), ``pysparkApplication`` (a Python file) or ``sparkConnectApplication``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_sparkapplications_cancel` @@ -1933,6 +2006,7 @@ Experimental in the DataLens API, written from its document and never called: no |---|---|:---:|---| | `cluster_id` | string | yes | Id of the Spark cluster. | | `application_id` | string | yes | Id of the Spark application. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `datalens_sparkapplications_log_list` diff --git a/docs/en/reference/mcp/forms.md b/docs/en/reference/mcp/forms.md index b5711f47..85f83dea 100644 --- a/docs/en/reference/mcp/forms.md +++ b/docs/en/reference/mcp/forms.md @@ -59,6 +59,7 @@ Only the fields you set are sent. Follow up with ``questions_create`` to add que | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | Typed request body for creating a form (``POST /surveys``). Every setting the API publishes is a field. The CLI has an option for the common ones; the rest are set with its common ``-F key=value`` and ``--body-file``. Unset (``None``) fields are dropped before the request is sent. ``language``, ``is_published`` and ``is_public`` are accepted and ignored by the API (checked live on 2026-10-04): they stay for callers that send them, and setting one logs a warning. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_surveys_update` @@ -72,6 +73,7 @@ Untouched settings keep their current values, so a partial patch is safe to repe |---|---|:---:|---| | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `body` | object | yes | Typed request body for modifying a form (``PATCH /surveys/{survey_id}``). Same optional fields as :class:`SurveyCreate`; only the fields you set are sent, so a partial patch never disturbs untouched settings. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_surveys_delete` @@ -84,6 +86,7 @@ The API answers ``204 No Content``; the returned record confirms the accepted ac | Parameter | Type | Required | Description | |---|---|:---:|---| | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_surveys_publish` @@ -97,6 +100,7 @@ Reverse with ``surveys_unpublish``. | Parameter | Type | Required | Description | |---|---|:---:|---| | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_surveys_unpublish` @@ -109,6 +113,7 @@ The API answers a bare ``200 OK``; the returned record confirms the accepted act | Parameter | Type | Required | Description | |---|---|:---:|---| | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_questions_list` @@ -150,6 +155,7 @@ afterwards with ``questions_move``. |---|---|:---:|---| | `survey_id` | string | yes | Form id (hex ObjectId) to add the question to. | | `body` | StringQuestion or BooleanQuestion or IntegerQuestion or FileQuestion or CommentQuestion or DateQuestion or DateRangeQuestion or PaymentQuestion or EnumQuestion or SuggestQuestion or MatrixQuestion or SeriesQuestion | yes | Typed question body; the ``type`` tag selects the question schema. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_questions_update` @@ -165,6 +171,7 @@ The body's ``type`` must match the existing question's type; look it up with | `survey_id` | string | yes | Form id (hex ObjectId) the question belongs to. | | `question_id` | string | yes | Question id (integer) to modify. | | `body` | StringQuestion or BooleanQuestion or IntegerQuestion or FileQuestion or CommentQuestion or DateQuestion or DateRangeQuestion or PaymentQuestion or EnumQuestion or SuggestQuestion or MatrixQuestion or SeriesQuestion | yes | Typed question body; ``type`` must match the existing question. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_questions_delete` @@ -181,6 +188,7 @@ The API answers ``204 No Content``; the returned record confirms the accepted ac | `survey_id` | string | yes | Form id (hex ObjectId) the question belongs to. | | `question_id` | string | yes | Question id (integer) to delete. | | `force` | boolean or null | | Ignored by the API: a question that a display condition refers to is refused all the same. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_questions_move` @@ -199,6 +207,7 @@ server-side — moving a question above one its conditions depend on is rejected | `survey_id` | string | yes | Form id (hex ObjectId) the question belongs to. | | `question_id` | string | yes | Question id (integer) to reposition. | | `body` | object | yes | Target placement: page / page_id / create_page and position. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_conditions_question_list` @@ -243,6 +252,7 @@ Returns the created group with its server-assigned integer ``id``. | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `question_id` | string | yes | Question id (integer) from questions_list. | | `body` | object | yes | The new group: operator + at least one clause. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_conditions_question_update` @@ -259,6 +269,7 @@ clause are both required; the group ``id`` is never sent. | `question_id` | string | yes | Question id (integer) from questions_list. | | `condition_id` | integer | yes | Condition group id (integer) from the matching *_list tool. | | `body` | object | yes | FULL replacement (PATCH validates the complete group). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_conditions_question_delete` @@ -271,6 +282,7 @@ Delete one condition group from a question; the other groups stay untouched. | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `question_id` | string | yes | Question id (integer) from questions_list. | | `condition_id` | integer | yes | Condition group id (integer) from the matching *_list tool. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_conditions_question_update_operator` @@ -285,6 +297,7 @@ Group-internal operators are untouched — change those via ``conditions_questio | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `question_id` | string | yes | Question id (integer) from questions_list. | | `operator` | `and` · `or` or string | yes | Boolean operator joining the condition groups. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_conditions_page_list` @@ -326,6 +339,7 @@ created group with its server-assigned integer ``id``. | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `page_id` | integer | yes | Page id (integer) from questions_list pages. | | `body` | object | yes | The new group: operator + at least one clause. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_conditions_page_update` @@ -339,6 +353,7 @@ Replace a page's condition group — a FULL replacement, not a partial update. | `page_id` | integer | yes | Page id (integer) from questions_list pages. | | `condition_id` | integer | yes | Condition group id (integer) from the matching *_list tool. | | `body` | object | yes | FULL replacement (PATCH validates the complete group). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_conditions_page_delete` @@ -351,6 +366,7 @@ Delete one condition group from a page; the other groups stay untouched. | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `page_id` | integer | yes | Page id (integer) from questions_list pages. | | `condition_id` | integer | yes | Condition group id (integer) from the matching *_list tool. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_conditions_page_update_operator` @@ -363,6 +379,7 @@ Set the boolean operator BETWEEN a page's condition groups; returns the envelope | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `page_id` | integer | yes | Page id (integer) from questions_list pages. | | `operator` | `and` · `or` or string | yes | Boolean operator joining the condition groups. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_conditions_submit_list` @@ -397,6 +414,7 @@ Add a condition group gating the form's submit button; returns it with its ``id` |---|---|:---:|---| | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `body` | object | yes | The new group: operator + at least one clause. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_conditions_submit_update` @@ -409,6 +427,7 @@ Replace a submit-button condition group — a FULL replacement, not a partial up | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `condition_id` | integer | yes | Condition group id (integer) from the matching *_list tool. | | `body` | object | yes | FULL replacement (PATCH validates the complete group). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_conditions_submit_delete` @@ -420,6 +439,7 @@ Delete one condition group from the submit button; the other groups stay untouch |---|---|:---:|---| | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `condition_id` | integer | yes | Condition group id (integer) from the matching *_list tool. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_conditions_submit_update_operator` @@ -431,6 +451,7 @@ Set the boolean operator BETWEEN the submit button's condition groups. |---|---|:---:|---| | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `operator` | `and` · `or` or string | yes | Boolean operator joining the condition groups. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_conditions_hook_list` @@ -468,6 +489,7 @@ Add a condition group to an integration group; returns it with its ``id``. | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `hook_id` | integer | yes | Integration group id (integer) from hooks_list. | | `body` | object | yes | The new group: operator + at least one clause. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_conditions_hook_update` @@ -481,6 +503,7 @@ Replace an integration group's condition group — a FULL replacement. | `hook_id` | integer | yes | Integration group id (integer) from hooks_list. | | `condition_id` | integer | yes | Condition group id (integer) from the matching *_list tool. | | `body` | object | yes | FULL replacement (PATCH validates the complete group). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_conditions_hook_delete` @@ -493,6 +516,7 @@ Delete one condition group from an integration group; the others stay untouched. | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `hook_id` | integer | yes | Integration group id (integer) from hooks_list. | | `condition_id` | integer | yes | Condition group id (integer) from the matching *_list tool. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_conditions_hook_update_operator` @@ -505,6 +529,7 @@ Set the boolean operator BETWEEN an integration group's condition groups. | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `hook_id` | integer | yes | Integration group id (integer) from hooks_list. | | `operator` | `and` · `or` or string | yes | Boolean operator joining the condition groups. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_access_list` @@ -531,6 +556,7 @@ Grants access: a client that honours the mark asks a person on every call. |---|---|:---:|---| | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `body` | object | yes | The action and its new access level. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_access_grant` @@ -546,6 +572,7 @@ Grants access: a client that honours the mark asks a person on every call. |---|---|:---:|---| | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `body` | object | yes | The action and the user or group to add. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_access_revoke` @@ -557,6 +584,7 @@ Stop a user or a group performing an action on a form; returns every permission. |---|---|:---:|---| | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `body` | object | yes | The action and the user or group to remove. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_history_list` @@ -638,6 +666,7 @@ An empty ``body`` exports every answer as ``xlsx``. Poll the returned ``id`` wit |---|---|:---:|---| | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `body` | object | yes | Typed request body for ``POST /v1/surveys/{id}/answers/export`` (start an async export). Every field is optional — the API defaults ``format`` to ``xlsx`` and ``upload`` to ``default``. Unset (``None``) fields are dropped before the request is sent, so a bare ``AnswerExport()`` exports every answer of the form in ``xlsx``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_answers_integrations_list` @@ -663,6 +692,7 @@ Delete one answer of a form; ``answers_restore`` brings it back. |---|---|:---:|---| | `survey_id` | string | yes | Form id (24-char hex). | | `answer_id` | integer | yes | Answer id (integer) from answers_list. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_answers_restore` @@ -674,6 +704,7 @@ Bring a deleted answer of a form back. |---|---|:---:|---| | `survey_id` | string | yes | Form id (24-char hex). | | `answer_id` | integer | yes | Id of the deleted answer (integer). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_keysets_list` @@ -717,6 +748,7 @@ The API rejects a body without ``is_enabled``, so set it explicitly alongside `` |---|---|:---:|---| | `survey_id` | string | yes | Form id (24-char hex) to add the key set to. | | `body` | object | yes | Key set settings; the API requires ``is_enabled`` on create. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_keysets_update` @@ -733,6 +765,7 @@ only grow: a number smaller than the set has now is refused. | `survey_id` | string | yes | Form id (24-char hex) the key set belongs to. | | `keyset_id` | integer | yes | Key set id (integer) from ``keysets_list``. | | `body` | object | yes | Full key set record — name, total and is_enabled are all required. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_keysets_delete` @@ -746,6 +779,7 @@ The API answers ``200 OK`` with no body, so a typed acknowledgement is returned. |---|---|:---:|---| | `survey_id` | string | yes | Form id (24-char hex) the key set belongs to. | | `keyset_id` | integer | yes | Key set id (integer) to delete. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_operations_get` @@ -822,6 +856,7 @@ A ``result.status`` of ``operation`` means it runs in the background: poll | Parameter | Type | Required | Description | |---|---|:---:|---| | `notification_id` | integer | yes | Notification id (integer) from notifications_list. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_notifications_cancel` @@ -834,6 +869,7 @@ A run that is already canceled or finished answers ``result.status`` ``skip``. | Parameter | Type | Required | Description | |---|---|:---:|---| | `notification_id` | integer | yes | Notification id (integer) from notifications_list. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_notifications_errors_list` @@ -875,6 +911,7 @@ no useful body, so the returned record confirms the accepted action. |---|---|:---:|---| | `path` | string or null | | File download path (from the upload response). | | `url` | string or null | | File download URL. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_images_clone` @@ -888,6 +925,7 @@ Reference the returned ``id`` from a question's, option's or form style's ``imag |---|---|:---:|---| | `survey_id` | string | yes | Form id (24-char hex). | | `body` | object | yes | The image to copy and the clone's name. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_filling_get` @@ -938,6 +976,7 @@ Returns the success-page payload (``answer_id`` confirms the save). | `body` | object | yes | Answer map keyed by question slug (see ``filling_get`` for the slugs). | | `validate_only` | boolean or null | | Validate only — saves nothing and fires no integrations. | | `key` | string or null | | Personal-link fill key, when the form uses one. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_hooks_list` @@ -977,6 +1016,7 @@ Add integrations with ``subscriptions_create`` and conditions with |---|---|:---:|---| | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `body` | object | yes | Group name and active flag (both optional). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_hooks_update` @@ -989,6 +1029,7 @@ Rename an integration group or switch it on or off; only the fields set change. | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `hook_id` | integer | yes | Integration group id (integer) from hooks_list. | | `body` | object | yes | Fields to change; unset ones stay. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_hooks_delete` @@ -1000,6 +1041,7 @@ Delete an integration group together with its integrations and conditions. |---|---|:---:|---| | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `hook_id` | integer | yes | Integration group id (integer) from hooks_list. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_subscriptions_list` @@ -1041,6 +1083,7 @@ integration with its integer ``id``. | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `hook_id` | integer | yes | Integration group id (integer) from hooks_list. | | `body` | object | yes | The integration; ``type`` selects its schema. Its schema is not listed here: read `Subscription` with schema_get(service="forms", name="Subscription"), then the definitions it refers to. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_subscriptions_update` @@ -1054,6 +1097,7 @@ Change an integration: only the fields set in ``body`` change. | `hook_id` | integer | yes | Integration group id (integer) from hooks_list. | | `subscription_id` | integer | yes | Integration id (integer) from subscriptions_list. | | `body` | object | yes | Fields to change; ``type`` must match the integration's type. Its schema is not listed here: read `Subscription` with schema_get(service="forms", name="Subscription"), then the definitions it refers to. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_subscriptions_delete` @@ -1066,6 +1110,7 @@ Delete one integration from a hook; the hook's other integrations stay. | `survey_id` | string | yes | Form id (24-char hex), from ``surveys_list``. | | `hook_id` | integer | yes | Integration group id (integer) from hooks_list. | | `subscription_id` | integer | yes | Integration id (integer) from subscriptions_list. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `forms_variables_list` diff --git a/docs/en/reference/mcp/tracker.md b/docs/en/reference/mcp/tracker.md index 0535d3a1..c9de870d 100644 --- a/docs/en/reference/mcp/tracker.md +++ b/docs/en/reference/mcp/tracker.md @@ -111,6 +111,7 @@ Create a Tracker issue; returns the new issue with its key. |---|---|:---:|---| | `body` | object | yes | Typed request body for ``POST /issues/`` (create an issue). Covers the common fields; ``extra="allow"`` lets any custom (global or queue-local) field pass through unvalidated. ``type``/``priority`` accept either a bare key string or a ``{"key": ...}`` object (both are valid per the Tracker API); the CLI sends the object form. | | `notify` | boolean or null | | Notify the users in the fields of the object; omitted, the API notifies. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_issues_update` @@ -124,6 +125,7 @@ Status is NOT changed here — use ``transitions_execute``. Returns the updated |---|---|:---:|---| | `issue_key` | string | yes | Issue key, e.g. QUEUE-123. | | `body` | object | yes | Typed request body for ``PATCH /issues/{key}`` (update an issue; only sent fields change). ``extra="allow"`` lets any custom field pass through unvalidated. Status is NOT changed here — use ``transitions_execute``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_issues_move` @@ -143,6 +145,7 @@ dropped. Returns the moved issue with its new key. | `move_all_fields` | boolean or null | | Keep the versions, components and projects the new queue also has. | | `notify` | boolean or null | | Notify the users in the fields of the object; omitted, the API notifies. | | `notify_author` | boolean or null | | Notify the author of the change; omitted, the API does not. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_issues_scroll_clear` @@ -156,6 +159,7 @@ Only a search by a scroll (`scroll_type`) has something to release; after this i | Parameter | Type | Required | Description | |---|---|:---:|---| | `next` | string | yes | The `next` a search by a scroll returned: it names the scroll. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_issues_update_bulk` @@ -170,6 +174,7 @@ Poll the returned operation id with ``bulk_get`` and inspect failures with |---|---|:---:|---| | `body` | object | yes | Typed request body for ``POST /bulkchange/_update`` (mass-edit issues). | | `notify` | boolean or null | | Notify the users in the fields of the object; omitted, the API notifies. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_issues_move_bulk` @@ -183,6 +188,7 @@ Poll with ``bulk_get``. |---|---|:---:|---| | `body` | object | yes | Typed request body for ``POST /bulkchange/_move`` (mass-move issues to another queue). | | `notify` | boolean or null | | Notify the users in the fields of the object; omitted, the API notifies. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_issues_transition_bulk` @@ -196,6 +202,7 @@ Poll with ``bulk_get``. |---|---|:---:|---| | `body` | object | yes | Typed request body for ``POST /bulkchange/_transition`` (mass status transition). | | `notify` | boolean or null | | Notify the users in the fields of the object; omitted, the API notifies. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_issues_import` @@ -208,6 +215,7 @@ Returns the imported issue. | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | Typed body for ``POST /issues/_import`` — import one issue, preserving its history. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_comments_list` @@ -248,6 +256,7 @@ Add a comment to a Tracker issue; returns the created comment. |---|---|:---:|---| | `issue_key` | string | yes | Issue key, e.g. QUEUE-123. | | `body` | object | yes | Typed request body for adding a comment to an issue or an entity. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_comments_update` @@ -262,6 +271,7 @@ Get ``comment_id`` from ``comments_list``. Returns the updated comment. | `issue_key` | string | yes | Issue key, e.g. QUEUE-123. | | `comment_id` | integer or string | yes | Comment id (numeric ``id`` or ``longId``), from ``comments_list``. | | `body` | object | yes | Typed request body for ``PATCH /issues/{key}/comments/{id}`` (edit a comment). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_comments_delete` @@ -275,6 +285,7 @@ Get ``comment_id`` from ``comments_list``. Returns an acknowledgement on success |---|---|:---:|---| | `issue_key` | string | yes | Issue key, e.g. QUEUE-123. | | `comment_id` | integer or string | yes | Comment id (numeric ``id`` or ``longId``), from ``comments_list``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_comments_reactions_create` @@ -290,6 +301,7 @@ with its updated reactions. | `issue_key` | string | yes | Issue key, e.g. QUEUE-123. | | `comment_id` | integer or string | yes | Comment id (numeric ``id`` or ``longId``), from ``comments_list``. | | `name` | string | yes | Reaction name, e.g. ``like``, ``dislike`` or ``fire``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_comments_import` @@ -303,6 +315,7 @@ Returns the imported comment. |---|---|:---:|---| | `issue_key` | string | yes | Issue key, e.g. QUEUE-123. | | `body` | object | yes | Typed body for ``POST /issues/{key}/comments/_import`` — import one comment with history. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_links_list` @@ -342,6 +355,7 @@ Link a Tracker issue to another issue; returns the created link. |---|---|:---:|---| | `issue_key` | string | yes | Issue key, e.g. QUEUE-123. | | `body` | object | yes | Typed request body for ``POST /issues/{key}/links`` (link to another issue). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_links_delete` @@ -355,6 +369,7 @@ Get ``link_id`` from ``links_list``. Returns an acknowledgement on success. |---|---|:---:|---| | `issue_key` | string | yes | Issue key, e.g. QUEUE-123. | | `link_id` | string | yes | Link id, from ``links_list``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_links_import` @@ -368,6 +383,7 @@ Returns the imported link. |---|---|:---:|---| | `issue_key` | string | yes | Issue key, e.g. QUEUE-123. | | `body` | object | yes | Typed body for ``POST /issues/{key}/links/_import`` — import one issue link with history. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_transitions_list` @@ -394,6 +410,7 @@ available from the new status. | `issue_key` | string | yes | Issue key, e.g. QUEUE-123. | | `transition_id` | string | yes | Transition id, from ``transitions_list``. | | `body` | object | yes | Typed request body for ``POST /issues/{key}/transitions/{id}/_execute``. Open-ended: any issue field can be set on transition (e.g. a resolution when closing), so ``extra="allow"`` lets arbitrary fields pass through unvalidated while the common fields below still document themselves in the MCP schema. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_worklog_list` @@ -452,6 +469,7 @@ Log spent time on a Tracker issue; returns the created worklog record. |---|---|:---:|---| | `issue_key` | string | yes | Issue key, e.g. QUEUE-123. | | `body` | object | yes | Typed request body for ``POST /issues/{key}/worklog`` (log time spent). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_worklog_update` @@ -466,6 +484,7 @@ Get ``record_id`` from ``worklog_list``. Returns the updated record. | `issue_key` | string | yes | Issue key, e.g. QUEUE-123. | | `record_id` | string | yes | Worklog record id, from ``worklog_list``. | | `body` | object | yes | Typed request body for ``PATCH /issues/{key}/worklog/{record_id}`` (edit an entry). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_worklog_delete` @@ -479,6 +498,7 @@ Get ``record_id`` from ``worklog_list``. Returns an acknowledgement on success. |---|---|:---:|---| | `issue_key` | string | yes | Issue key, e.g. QUEUE-123. | | `record_id` | string | yes | Worklog record id, from ``worklog_list``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_worklog_import` @@ -492,6 +512,7 @@ Returns the imported record(s) — the endpoint answers with a JSON array. |---|---|:---:|---| | `issue_key` | string | yes | Issue key, e.g. QUEUE-123. | | `body` | object | yes | Typed body for ``POST /issues/{key}/worklogs/_import`` — import one worklog with history. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_changelog_list` @@ -537,6 +558,7 @@ Returns the issue with its full checklist. |---|---|:---:|---| | `issue_key` | string | yes | Issue key, e.g. QUEUE-123. | | `body` | object | yes | Typed request body for ``POST /issues/{key}/checklistItems`` (add an item). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_checklists_update` @@ -551,6 +573,7 @@ Get ``item_id`` from ``checklists_list``. Returns the issue with its updated che | `issue_key` | string | yes | Issue key, e.g. QUEUE-123. | | `item_id` | string | yes | Checklist item id, from ``checklists_list``. | | `body` | object | yes | Typed request body for ``PATCH /issues/{key}/checklistItems/{item_id}`` (edit an item). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_checklists_delete` @@ -564,6 +587,7 @@ Get ``item_id`` from ``checklists_list``. Returns the issue with its remaining c |---|---|:---:|---| | `issue_key` | string | yes | Issue key, e.g. QUEUE-123. | | `item_id` | string | yes | Checklist item id, from ``checklists_list``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_checklists_clear` @@ -576,6 +600,7 @@ Returns the issue without its checklist. | Parameter | Type | Required | Description | |---|---|:---:|---| | `issue_key` | string | yes | Issue key, e.g. QUEUE-123. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_columns_list` @@ -618,6 +643,7 @@ required; ``limit`` optionally caps the number of issues allowed in the column. |---|---|:---:|---| | `board_id` | integer | yes | Numeric identifier of the agile board. | | `body` | object | yes | Typed request body for ``columns.create`` (``POST /boards/{board_id}/columns/``). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_columns_update` @@ -632,6 +658,7 @@ Get ``column_id`` from ``columns_list``. Returns the updated column. | `board_id` | integer | yes | Numeric identifier of the agile board. | | `column_id` | integer | yes | Numeric identifier of the board column. | | `body` | object | yes | Typed request body for ``columns.edit`` (``PATCH /boards/{board_id}/columns/{column_id}``). Every field is optional; only the fields you set are sent. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_columns_delete` @@ -645,6 +672,7 @@ Returns an acknowledgement on success. |---|---|:---:|---| | `board_id` | integer | yes | Numeric identifier of the agile board. | | `column_id` | integer | yes | Numeric identifier of the board column. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_priorities_list` @@ -668,6 +696,7 @@ permanent residue. ``key`` is the latin identifier; ``name`` holds the ru/en dis | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | Typed request body for ``POST /priorities/`` (create a priority). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_priorities_update` @@ -683,6 +712,7 @@ concurrent edits (optimistic locking). | `priority_id` | string | yes | Priority id or key, from ``priorities_list``. | | `body` | object | yes | Typed request body for ``PATCH /priorities/{id}?version=`` (edit a priority). Only the fields that are set are sent, so omitted fields stay unchanged. | | `version` | integer or null | | Current version of the object (optimistic lock), from its get/list tool. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_issuetypes_list` @@ -702,6 +732,7 @@ permanent residue. ``key`` is the latin identifier; ``name`` holds the ru/en dis | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | Typed request body for ``POST /issuetypes/`` (create an issue type). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_issuetypes_update` @@ -717,6 +748,7 @@ concurrent edits (optimistic locking). | `issue_type_id` | string | yes | Issue type id or key, from ``issuetypes_list``. | | `body` | object | yes | Typed request body for ``PATCH /issuetypes/{id}?version=`` (edit an issue type). Only the fields that are set are sent, so omitted fields stay unchanged. | | `version` | integer or null | | Current version of the object (optimistic lock), from its get/list tool. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_linktypes_list` @@ -778,6 +810,7 @@ permanent residue. ``key`` is the latin identifier, ``name`` holds the ru/en dis | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | Typed request body for ``POST /statuses/`` (create an issue status). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_statuses_update` @@ -793,6 +826,7 @@ edits (optimistic locking). | `status_id` | string | yes | Status id or key, from ``statuses_list``. | | `body` | object | yes | Typed request body for ``PATCH /statuses/{id}?version=`` (edit a status). Only the fields that are set are sent, so omitted fields stay unchanged. | | `version` | integer or null | | Current version of the object (optimistic lock), from its get/list tool. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_resolutions_list` @@ -816,6 +850,7 @@ permanent residue. ``key`` is the latin identifier; ``name`` holds the ru/en dis | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | Typed request body for ``POST /resolutions/`` (create a resolution). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_resolutions_update` @@ -831,6 +866,7 @@ concurrent edits (optimistic locking). | `resolution_id` | string | yes | Resolution id or key, from ``resolutions_list``. | | `body` | object | yes | Typed request body for ``PATCH /resolutions/{id}?version=`` (edit a resolution). Only the fields that are set are sent, so omitted fields stay unchanged. | | `version` | integer or null | | Current version of the object (optimistic lock), from its get/list tool. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_queues_list` @@ -916,6 +952,7 @@ the new queue. | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | Typed request body for ``queues.create`` (``POST /queues/``). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_queues_delete` @@ -929,6 +966,7 @@ acknowledgement on success. | Parameter | Type | Required | Description | |---|---|:---:|---| | `queue_id` | string | yes | Queue key (case-sensitive, e.g. TEST) or numeric queue id. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_queues_restore` @@ -941,6 +979,7 @@ Returns the restored queue. | Parameter | Type | Required | Description | |---|---|:---:|---| | `queue_id` | string | yes | Queue key (case-sensitive, e.g. TEST) or numeric queue id. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_queues_permissions_update` @@ -960,6 +999,7 @@ Grants access: a client that honours the mark asks a person on every call. |---|---|:---:|---| | `queue_id` | string | yes | Queue key (case-sensitive, e.g. TEST) or numeric queue id. | | `body` | object | yes | Typed request body for ``queues.permissions_update`` (``PATCH /queues/{id}/permissions``). Set at least one category. Each names the users/groups/roles the permission applies to. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_queues_tags_delete` @@ -974,6 +1014,7 @@ acknowledgement on success. |---|---|:---:|---| | `queue_id` | string | yes | Queue key (case-sensitive, e.g. TEST) or numeric queue id. | | `body` | object | yes | Typed request body for ``queues.tags_delete`` (``POST /queues/{id}/tags/_remove``). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_queues_versions_create` @@ -987,6 +1028,7 @@ Required: ``queue`` (the queue key) and ``name``; optional ``description``, | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | Typed request body for ``queues.versions_create`` (``POST /versions/``). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_queues_versions_get` @@ -1010,6 +1052,7 @@ Edit a queue version; only the fields set in ``body`` change. Returns the versio | `version_id` | integer | yes | Numeric id of the version, from ``queues_versions_list``. | | `body` | object | yes | Typed request body for ``queues.version_edit`` (``PATCH /versions/{id}``). Only the fields that are set are sent, so omitted fields stay unchanged. | | `fields` | string or null | | Comma-separated fields to return in the reply. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_queues_versions_delete` @@ -1020,6 +1063,7 @@ Permanently delete a queue version (irreversible). Returns an acknowledgement. | Parameter | Type | Required | Description | |---|---|:---:|---| | `version_id` | integer | yes | Numeric id of the version, from ``queues_versions_list``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_queues_user_permissions_get` @@ -1088,6 +1132,7 @@ StringFieldType``). There is no delete endpoint — the field lives until its qu |---|---|:---:|---| | `queue_id` | string | yes | Queue key (case-sensitive, e.g. TEST) or numeric queue id. | | `body` | object | yes | Typed request body for creating an issue field, global or local to a queue. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_localfields_update` @@ -1102,6 +1147,7 @@ Get ``field_key`` from ``localfields_list``. Returns the updated field definitio | `queue_id` | string | yes | Queue key (case-sensitive, e.g. TEST) or numeric queue id. | | `field_key` | string | yes | Key of the queue-local field, from ``localfields_list``. | | `body` | object | yes | Typed request body for ``PATCH /queues/{id}/localFields/{key}`` (edit a local field). This endpoint has no ``?version=`` optimistic lock; only the fields that are set are sent. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_fields_list` @@ -1140,6 +1186,7 @@ A name is unique among the fields: one that is taken answers 422 (measured). | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | Typed request body for creating an issue field, global or local to a queue. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_fields_update` @@ -1155,6 +1202,7 @@ updated field definition. | `field_id` | string | yes | Identifier of the issue field, from ``fields_list``. | | `body` | object | yes | Typed request body for ``PATCH /fields/{id}?version=`` (rename and/or change options). Rename and change-options share one PATCH, so this one body covers both ``name`` and ``optionsProvider``; only the fields that are set are sent. | | `version` | integer or null | | Current version of the object (optimistic lock), from its get/list tool. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_fields_categories_create` @@ -1168,6 +1216,7 @@ org-global and not deletable via the API. | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | Typed request body for ``POST /fields/categories`` (create a field category). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_fields_categories_update` @@ -1182,6 +1231,7 @@ Pass ``version`` to guard against concurrent edits (optimistic locking). | `category_id` | string | yes | Identifier of the field category. | | `body` | object | yes | Typed request body for ``PATCH /fields/categories/{id}?version=`` (edit a category). Only the fields that are set are sent, so omitted fields stay unchanged. | | `version` | integer or null | | Current version of the object (optimistic lock), from its get/list tool. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_components_list` @@ -1205,6 +1255,7 @@ Create a component in a queue (a sub-area for classifying its issues). | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | Typed request body for ``POST /components`` (create a component). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_components_update` @@ -1220,6 +1271,7 @@ edits (optimistic locking). | `component_id` | integer | yes | Numeric id of the component, from ``components_list``. | | `body` | object | yes | Typed request body for ``PATCH /components/{id}?version=`` (edit a component). Only the fields that are set are sent, so omitted fields stay unchanged. | | `version` | integer or null | | Current version of the object (optimistic lock), from its get/list tool. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_components_list_for_queue` @@ -1252,6 +1304,7 @@ Permanently delete a component (irreversible). Returns an acknowledgement. | Parameter | Type | Required | Description | |---|---|:---:|---| | `component_id` | integer | yes | Numeric id of the component, from ``components_list``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_components_user_permissions_get` @@ -1301,6 +1354,7 @@ the stored search. Remove it later with ``filters_delete``. | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | Typed request body for ``POST /filters/`` (create a saved filter). Pass either ``filter`` (a field→condition mapping) or ``query`` (a Tracker query string), not both. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_filters_update` @@ -1314,6 +1368,7 @@ Get ``filter_id`` from ``filters_get`` / the Tracker UI. Returns the updated fil |---|---|:---:|---| | `filter_id` | string | yes | Identifier of the saved filter, from ``filters_get``. | | `body` | object | yes | Typed request body for ``PATCH /filters/{id}`` (edit a saved filter). Only the fields that are set are sent; note the API replaces ``filter`` wholesale rather than merging it, so pass every condition you want to keep. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_filters_delete` @@ -1326,6 +1381,7 @@ Returns an acknowledgement on success. | Parameter | Type | Required | Description | |---|---|:---:|---| | `filter_id` | string | yes | Numeric identifier of the saved filter, e.g. 12345. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_applications_list` @@ -1379,6 +1435,7 @@ permissions template, the ``backlog_available``/``sprints_available`` flags and | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | Typed request body for ``boards.create`` (``POST /liveBoards/``). ``name`` is the only required field; every other field is omitted from the JSON body when left as ``None`` (see ``model_dump(exclude_none=True)``). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_boards_update` @@ -1393,6 +1450,7 @@ Supports renaming, toggling ``backlog_available``/``sprints_available`` and repl |---|---|:---:|---| | `board_id` | integer | yes | Numeric identifier of the agile board. | | `body` | object | yes | Typed request body for ``boards.edit`` (``PATCH /boards/{board_id}``). Every field is optional; only the fields you set are sent, so an omitted field is left unchanged on the board. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_boards_delete` @@ -1405,6 +1463,7 @@ Returns an acknowledgement on success. | Parameter | Type | Required | Description | |---|---|:---:|---| | `board_id` | integer | yes | Numeric identifier of the agile board. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_sprints_list` @@ -1446,6 +1505,7 @@ Required fields: ``name``, ``board`` (``{"id": ""}``), ``start_date`` | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | Typed request body for ``sprints.create`` (``POST /sprints``). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_sprints_update` @@ -1462,6 +1522,7 @@ one. Returns the updated sprint. | `sprint_id` | integer | yes | Numeric identifier of the sprint. | | `body` | object | yes | Typed request body for ``sprints.edit`` (``PATCH /sprints/{sprint_id}``). Every field is optional; only the fields you set are sent. | | `version` | integer or null | | Current version of the object (optimistic lock), from its get/list tool. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_sprints_delete` @@ -1474,6 +1535,7 @@ Returns an acknowledgement on success. | Parameter | Type | Required | Description | |---|---|:---:|---| | `sprint_id` | integer | yes | Numeric identifier of the sprint. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_sprints_start` @@ -1488,6 +1550,7 @@ it for optimistic locking and answers 428 without one. Returns the updated sprin |---|---|:---:|---| | `sprint_id` | integer | yes | Numeric identifier of the sprint. | | `version` | integer or null | | Current version of the object (optimistic lock), from its get/list tool. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_sprints_archive` @@ -1502,6 +1565,7 @@ it for optimistic locking and answers 428 without one. Returns the updated sprin |---|---|:---:|---| | `sprint_id` | integer | yes | Numeric identifier of the sprint. | | `version` | integer or null | | Current version of the object (optimistic lock), from its get/list tool. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_attachments_list` @@ -1543,6 +1607,7 @@ Get ``file_id`` from ``attachments_list``. Returns an acknowledgement on success |---|---|:---:|---| | `issue_key` | string | yes | Issue key or id, e.g. ``JUNE-2``. | | `file_id` | string | yes | Attachment file id, from ``attachments_list``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_attachments_upload` @@ -1559,6 +1624,7 @@ The file travels as base64 in the request, so keep it small; for a large file ru | `filename` | string | yes | Name of the file being uploaded. | | `data` | string | yes | The file's bytes, base64-encoded. | | `rename_to` | string or null | | Store the file under this name instead of ``filename``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_attachments_upload_temp` @@ -1574,6 +1640,7 @@ once. The file travels as base64 in the request, so keep it small. | `filename` | string | yes | Name of the file being uploaded. | | `data` | string | yes | The file's bytes, base64-encoded. | | `rename_to` | string or null | | Store the file under this name instead of ``filename``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_attachments_import` @@ -1592,6 +1659,7 @@ The file travels as base64 in the request, so keep it small; for a large file ru | `created_at` | string | yes | Original creation time, ``YYYY-MM-DDThh:mm:ss.sss±hhmm``. | | `created_by` | string | yes | Login or id of the user to record as the file's author. | | `data` | string | yes | The file's bytes, base64-encoded. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_macros_list` @@ -1633,6 +1701,7 @@ Create a macro on a queue (a canned comment plus field updates applied on demand |---|---|:---:|---| | `queue_id` | string | yes | Queue key (case-sensitive, e.g. TEST) or numeric queue id. | | `body` | object | yes | Typed request body for ``macros.create`` (``POST /queues/{id}/macros``). ``issue_update`` here is a field→value *object* (not the list the read side returns), e.g. ``{"tags": {"add": "Новый тег"}, "resolution": None}``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_macros_update` @@ -1647,6 +1716,7 @@ Get ``macro_id`` from ``macros_list``. Returns the updated macro. | `queue_id` | string | yes | Queue key (case-sensitive, e.g. TEST) or numeric queue id. | | `macro_id` | integer | yes | Numeric identifier of the macro, from ``macros_list``. | | `body` | object | yes | Typed request body for ``macros.edit`` (``PATCH /queues/{id}/macros/{macro_id}``). Every field is optional; only the fields you set are sent. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_macros_delete` @@ -1660,6 +1730,7 @@ Returns an acknowledgement on success. |---|---|:---:|---| | `queue_id` | string | yes | Queue key (case-sensitive, e.g. TEST) or numeric queue id. | | `macro_id` | integer | yes | Numeric identifier of the macro, from ``macros_list``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_triggers_list` @@ -1722,6 +1793,7 @@ Required: ``name`` and ``actions`` (e.g. ``[{"type": "Transition", …}]``); opt |---|---|:---:|---| | `queue_id` | string | yes | Queue key (case-sensitive, e.g. TEST) or numeric queue id. | | `body` | TriggerCreate | yes | Trigger name, actions and optional conditions. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_triggers_update` @@ -1738,6 +1810,7 @@ against concurrent edits (optimistic locking). | `trigger_id` | integer | yes | Numeric trigger id, from ``triggers_list``. | | `body` | TriggerUpdate | yes | Fields to change; unset ones stay. | | `version` | integer or null | | Current version of the object (optimistic lock), from its get/list tool. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_autoactions_get` @@ -1798,6 +1871,7 @@ deleted (it can be disabled in the UI). |---|---|:---:|---| | `queue_id` | string | yes | Queue key (case-sensitive, e.g. TEST) or numeric queue id. | | `body` | object | yes | Typed request body for ``autoactions.create`` (``POST /queues/{id}/autoactions``). Supply at least one of ``filter`` or ``query`` to select the issues to act on. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_bulk_get` @@ -1855,6 +1929,7 @@ to also create the mirror link in the external app. | `issue_key` | string | yes | Issue key, e.g. QUEUE-123. | | `body` | object | yes | Typed request body for ``POST /issues/{key}/remotelinks`` (add an external link). | | `backlink` | boolean or null | | Also create the mirror link in the external application. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_remotelinks_delete` @@ -1868,6 +1943,7 @@ Get ``link_id`` from ``remotelinks_list``. Returns an acknowledgement on success |---|---|:---:|---| | `issue_key` | string | yes | Issue key, e.g. QUEUE-123. | | `link_id` | string | yes | Remote link id, from ``remotelinks_list``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_dashboards_create` @@ -1881,6 +1957,7 @@ until removed in the UI. | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | Typed request body for ``POST /dashboards/`` (create a dashboard). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_dashboards_widgets_create_cycle_time` @@ -1894,6 +1971,7 @@ Get ``dashboard_id`` from ``dashboards_create``. |---|---|:---:|---| | `dashboard_id` | string | yes | Id of the dashboard to add the widget to. | | `body` | object | yes | Typed request body for ``POST /dashboards/{id}/widgets/cycleTime`` (add a cycle-time chart). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_entities_get` @@ -2087,6 +2165,7 @@ Create a Tracker entity (project, portfolio or goal); returns it with its id. | `entity_type` | string | yes | Entity type: ``project``, ``portfolio`` or ``goal``. | | `body` | object | yes | Typed request body for ``POST /entities/{type}`` — a ``{fields: {...}}`` envelope. | | `fields` | string or null | | Comma-separated fields to include in the reply. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_entities_update` @@ -2103,6 +2182,7 @@ Returns the updated entity. | `body` | object | yes | Typed request body for ``PATCH /entities/{type}/{id}`` (edit fields, comment, links). | | `expand` | string or null | | Extra blocks to include in the reply. | | `fields` | string or null | | Comma-separated fields to include in the reply. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_entities_delete` @@ -2118,6 +2198,7 @@ acknowledgement on success. | `entity_type` | string | yes | Entity type: ``project``, ``portfolio`` or ``goal``. | | `entity_id` | string | yes | Entity id (or shortId). | | `with_board` | boolean or null | | Also delete the project's linked board. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_entities_permissions_update` @@ -2137,6 +2218,7 @@ Grants access: a client that honours the mark asks a person on every call. | `entity_type` | string | yes | Entity type: ``project``, ``portfolio`` or ``goal``. | | `entity_id` | string | yes | Entity id (or shortId). | | `body` | object | yes | Typed request body for ``PATCH …/extendedPermissions``: rights to grant and to revoke. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_entities_permissions_update_direct` @@ -2155,6 +2237,7 @@ Grants access: a client that honours the mark asks a person on every call. | `entity_type` | string | yes | Entity type: ``project``, ``portfolio`` or ``goal``. | | `entity_id` | string | yes | Entity id (or shortId). | | `body` | object | yes | Typed request body for ``PATCH …/permissions`` (grant and revoke direct rights). Each side maps an access level (READ / WRITE / GRANT) to users, groups and roles; the API adds or removes exactly those and keeps the rest. ``permissionSources`` is refused (400). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_entities_update_bulk` @@ -2168,6 +2251,7 @@ Poll the returned operation id with ``entities_bulk_get``. |---|---|:---:|---| | `entity_type` | string | yes | Entity type: ``project``, ``portfolio`` or ``goal``. | | `body` | object | yes | Typed request body for ``POST …/bulkchange/_update`` (mass-edit entities). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_entities_reports_create` @@ -2180,6 +2264,7 @@ Returns the report entity. | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | Typed request body for ``POST /entities/report/`` — a ``{fields: {...}}`` envelope. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_entities_comments_create` @@ -2196,6 +2281,7 @@ Add a comment to a Tracker entity; returns the created comment. | `is_add_to_followers` | boolean or null | | Add the comment's author to the followers; omitted, the API adds. | | `notify` | boolean or null | | Notify the users in the fields of the object; omitted, the API notifies. | | `notify_author` | boolean or null | | Notify the author of the change; omitted, the API does not. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_entities_comments_update` @@ -2215,6 +2301,7 @@ Edit a comment on a Tracker entity; returns the updated comment. | `is_add_to_followers` | boolean or null | | Add the comment's author to the followers; omitted, the API adds. | | `notify` | boolean or null | | Notify the users in the fields of the object; omitted, the API notifies. | | `notify_author` | boolean or null | | Notify the author of the change; omitted, the API does not. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_entities_comments_delete` @@ -2231,6 +2318,7 @@ Returns an acknowledgement on success. | `comment_id` | string | yes | Comment id (from entities_comments_list). | | `notify` | boolean or null | | Notify the users in the fields of the object; omitted, the API notifies. | | `notify_author` | boolean or null | | Notify the author of the change; omitted, the API does not. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_entities_checklists_create` @@ -2249,6 +2337,7 @@ Add checklist item(s) to a Tracker entity; returns the entity with its checklist | `fields` | string or null | | Comma-separated fields to include in the reply. | | `notify` | boolean or null | | Notify the users in the fields of the object; omitted, the API notifies. | | `notify_author` | boolean or null | | Notify the author of the change; omitted, the API does not. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_entities_checklists_update` @@ -2268,6 +2357,7 @@ item by id use ``entities_checklists_items_update``. Returns the entity with its | `fields` | string or null | | Comma-separated fields to include in the reply. | | `notify` | boolean or null | | Notify the users in the fields of the object; omitted, the API notifies. | | `notify_author` | boolean or null | | Notify the author of the change; omitted, the API does not. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_entities_checklists_items_update` @@ -2287,6 +2377,7 @@ Returns the entity with its updated checklist. | `fields` | string or null | | Comma-separated fields to include in the reply. | | `notify` | boolean or null | | Notify the users in the fields of the object; omitted, the API notifies. | | `notify_author` | boolean or null | | Notify the author of the change; omitted, the API does not. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_entities_checklists_delete` @@ -2304,6 +2395,7 @@ To remove a single item use ``entities_checklists_items_delete``. Returns the en | `fields` | string or null | | Comma-separated fields to include in the reply. | | `notify` | boolean or null | | Notify the users in the fields of the object; omitted, the API notifies. | | `notify_author` | boolean or null | | Notify the author of the change; omitted, the API does not. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_entities_checklists_items_delete` @@ -2322,6 +2414,7 @@ Returns the entity with its remaining checklist. | `fields` | string or null | | Comma-separated fields to include in the reply. | | `notify` | boolean or null | | Notify the users in the fields of the object; omitted, the API notifies. | | `notify_author` | boolean or null | | Notify the author of the change; omitted, the API does not. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_entities_checklists_move` @@ -2341,6 +2434,7 @@ Returns the entity with its reordered checklist. | `fields` | string or null | | Comma-separated fields to include in the reply. | | `notify` | boolean or null | | Notify the users in the fields of the object; omitted, the API notifies. | | `notify_author` | boolean or null | | Notify the author of the change; omitted, the API does not. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_entities_links_create` @@ -2355,6 +2449,7 @@ Returns an acknowledgement on success. | `entity_type` | string | yes | Entity type: ``project``, ``portfolio`` or ``goal``. | | `entity_id` | string | yes | Entity id (or shortId). | | `body` | object | yes | A link spec used by create-link and the bulk ``values.links`` array. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_entities_links_delete` @@ -2370,6 +2465,7 @@ an acknowledgement on success. | `entity_type` | string | yes | Entity type: ``project``, ``portfolio`` or ``goal``. | | `entity_id` | string | yes | Entity id (or shortId). | | `right` | string | yes | Id of the linked entity to unlink. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_entities_attachments_attach` @@ -2389,6 +2485,7 @@ ycli — files are usually seeded via the UI). Returns the entity. | `fields` | string or null | | Comma-separated fields to include in the reply. | | `notify` | boolean or null | | Notify the users in the fields of the object; omitted, the API notifies. | | `notify_author` | boolean or null | | Notify the author of the change; omitted, the API does not. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_entities_attachments_delete` @@ -2403,6 +2500,7 @@ The API answers with an empty body; returns an acknowledgement on success. | `entity_type` | string | yes | Entity type: ``project``, ``portfolio`` or ``goal``. | | `entity_id` | string | yes | Entity id (or shortId). | | `file_id` | string | yes | Attachment file id (from entities_attachments_list). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_workflows_list` @@ -2448,6 +2546,7 @@ with its ``actions``). Statuses are given as keys such as ``open`` and must exis | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | Typed request body for ``workflows.create`` (``POST /workflows``). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_workflows_update` @@ -2463,6 +2562,7 @@ list. Returns the workflow with its incremented version. | `workflow_id` | string | yes | Workflow id, from ``workflows_list``. | | `body` | object | yes | Typed request body for ``workflows.edit`` (``PATCH /workflows/{id}``). Only the fields that are set change; a given ``steps`` list replaces the whole step list. | | `version` | integer | yes | Current version of the workflow (optimistic lock), from ``workflows_get``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_workflows_actions_update` @@ -2479,6 +2579,7 @@ Returns the whole workflow with its incremented version. | `action_id` | string | yes | Id of the action within that step. | | `body` | object | yes | Typed request body for ``workflows.edit_action``. The docs mark every field optional, but Tracker refuses an edit without ``name`` and ``target`` (422), so both are required; the other fields change only when set. | | `version` | integer | yes | Current version of the workflow (optimistic lock), from ``workflows_get``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_workflows_delete` @@ -2489,6 +2590,7 @@ Delete a workflow (irreversible). Returns an acknowledgement. | Parameter | Type | Required | Description | |---|---|:---:|---| | `workflow_id` | string | yes | Workflow id, from ``workflows_list``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_projects_list` @@ -2536,6 +2638,7 @@ service accepts ``queues`` (a queue key) and binds no queue. Returns the project | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | Typed request body for ``projects.create`` (``POST /projects``). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_projects_update` @@ -2551,6 +2654,7 @@ Returns the project with its incremented version. | `body` | object | yes | Typed request body for ``projects.edit`` (``PUT /projects/{id}?version=``). ``queues`` is required by the API on every edit; the rest change when set. | | `version` | integer | yes | Current version of the project, from ``projects_get``. | | `expand` | string or null | | Extra blocks to include, e.g. ``queues``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_projects_delete` @@ -2561,6 +2665,7 @@ Delete a project (irreversible). Returns an acknowledgement. | Parameter | Type | Required | Description | |---|---|:---:|---| | `project_id` | integer | yes | Numeric id of the project, from ``projects_list``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_gaps_search` @@ -2593,6 +2698,7 @@ conference_trip, conference, learning, maternity or duty), ``from`` and ``to`` ( | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | Typed request body for ``gaps.create`` (``POST /gaps``): up to 100 absences. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `tracker_gaps_delete` @@ -2605,3 +2711,4 @@ Needs Tracker administrator rights. Returns an acknowledgement. | Parameter | Type | Required | Description | |---|---|:---:|---| | `gap_ids` | array of string | yes | Ids of the absences to delete (up to 100), from a search. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | diff --git a/docs/en/reference/mcp/wiki.md b/docs/en/reference/mcp/wiki.md index b7834088..193ef075 100644 --- a/docs/en/reference/mcp/wiki.md +++ b/docs/en/reference/mcp/wiki.md @@ -128,6 +128,7 @@ then answers 404 and links to it break, so pick the slug carefully. Returns the | `body` | object | yes | Typed request body for ``POST /pages``: a new page at ``slug``. | | `fields` | string or null | | Extra blocks to include in the reply (CSV), e.g. ``content,attributes``. | | `is_silent` | boolean or null | | Do not notify the page's subscribers. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_pages_update` @@ -147,6 +148,7 @@ handles that quirk. Repeating the same call yields the same page state (idempote | `fields` | string or null | | Extra blocks to include in the reply (CSV), e.g. ``content,attributes``. | | `is_silent` | boolean or null | | Do not notify the page's subscribers. | | `allow_merge` | boolean or null | | Merge with a concurrent edit (3-way merge) instead of failing. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_pages_delete` @@ -162,6 +164,7 @@ anchor too, so double-check the id (``pages_get_by_id``) before calling. |---|---|:---:|---| | `page_id` | integer | yes | Numeric id of the page to delete. | | `recursive` | boolean or null | | Also delete every page under it. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_pages_append` @@ -179,6 +182,7 @@ text ``body.anchor``. Returns the updated page. | `body` | object | yes | What to append and where: required ``content`` (YFM fragment) plus optional ``body`` (top/bottom), ``section`` or ``anchor`` placement. | | `fields` | string or null | | Extra blocks to include in the reply (CSV), e.g. ``content,attributes``. | | `is_silent` | boolean or null | | Do not notify the page's subscribers. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_pages_clone` @@ -194,6 +198,7 @@ Cloning leaves the original where it is; to give the page itself a new slug use |---|---|:---:|---| | `page_id` | integer | yes | Numeric id of the page to copy. | | `body` | object | yes | Clone spec: required ``target`` (destination slug) plus optional ``title`` and ``subscribe_me``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_pages_move` @@ -212,6 +217,7 @@ and may change it. |---|---|:---:|---| | `body` | object | yes | Move spec: ``operations`` (each ``source`` slug and new ``target`` slug, optionally ``next_to_slug`` with ``position`` before/after) and optional ``copy_inherited_access``. | | `validate_only` | boolean or null | | Validate the move without applying it. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_pages_revisions_list` @@ -283,6 +289,7 @@ Grants access: a client that honours the mark asks a person on every call. |---|---|:---:|---| | `page_id` | integer | yes | Numeric id of the page. | | `body` | object | yes | The grant: exactly one of ``user`` (uid / cloud_uid) and ``group`` (src + id), the ``role``, and optionally ``inheritance``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_access_update` @@ -300,6 +307,7 @@ Grants access: a client that honours the mark asks a person on every call. | `access_id` | string | yes | Id of the access entry, from the page's ``access_lists``. | | `body` | object | yes | The new ``role`` and/or ``inheritance`` (one at least). | | `prevent_selflock` | boolean or null | | Refuse the change if it would leave you without read access or the right to change accesses. Set it unless you mean to lock yourself out. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_access_delete` @@ -314,6 +322,7 @@ The page owner's own entry cannot be revoked. | `page_id` | integer | yes | Numeric id of the page. | | `access_id` | string | yes | Id of the access entry, from the page's ``access_lists``. | | `prevent_selflock` | boolean or null | | Refuse the change if it would leave you without read access or the right to change accesses. Set it unless you mean to lock yourself out. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_access_clear` @@ -328,6 +337,7 @@ entries are not kept. |---|---|:---:|---| | `page_id` | integer | yes | Numeric id of the page. | | `prevent_selflock` | boolean or null | | Refuse the change if it would leave you without read access or the right to change accesses. Set it unless you mean to lock yourself out. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_comments_list` @@ -397,6 +407,7 @@ Pass ``body.parent_id`` to reply to an existing comment — find ids with |---|---|:---:|---| | `page_id` | integer | yes | Numeric id of the page to comment on. | | `body` | object | yes | The comment: required ``body`` text plus optional placement — ``inline_text`` (pin to a page fragment), ``parent_id`` (reply), ``thread_id``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_comments_delete` @@ -412,6 +423,7 @@ replies' threading. |---|---|:---:|---| | `page_id` | integer | yes | Numeric id of the page the comment lives on. | | `comment_id` | integer | yes | Numeric id of the comment to delete. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_attachments_list` @@ -461,6 +473,7 @@ a single call. Returns the newly-attached files. |---|---|:---:|---| | `page_id` | integer | yes | Numeric id of the page to attach to. | | `session_ids` | array of string | yes | ``session_id`` of each FINISHED upload session to attach. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_attachments_upload` @@ -479,6 +492,7 @@ newly-attached files. | `page_id` | integer | yes | Numeric id of the page to attach the file to. | | `file_name` | string | yes | Name to give the uploaded file. | | `data` | string | yes | The file's bytes, base64-encoded. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_attachments_delete` @@ -493,6 +507,7 @@ The API answers ``204 No Content``; a typed acknowledgement is returned instead. |---|---|:---:|---| | `page_id` | integer | yes | Numeric id of the page the file is attached to. | | `file_id` | integer | yes | Numeric id of the attachment to delete. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_resources_list` @@ -529,6 +544,7 @@ the path is the whole request. | Parameter | Type | Required | Description | |---|---|:---:|---| | `token` | string | yes | UUID4 ``recovery_token`` returned by ``pages_delete``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_grids_get` @@ -564,6 +580,7 @@ A new grid has no rows or columns — add them afterwards with ``grids_columns_c | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | Grid spec: ``title`` plus the ``page`` (by id or slug) to live on. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_grids_update` @@ -578,6 +595,7 @@ a mismatch fails the write. Returns the grid's new ``revision``. |---|---|:---:|---| | `grid_id` | string | yes | The grid's permanent UUID4 id. | | `body` | object | yes | Editable fields (``title``, ``default_sort``) plus the required ``revision``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_grids_delete` @@ -591,6 +609,7 @@ result is a typed acknowledgement. | Parameter | Type | Required | Description | |---|---|:---:|---| | `grid_id` | string | yes | The grid's permanent UUID4 id. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_grids_rows_create` @@ -605,6 +624,7 @@ the grid's new ``revision``. |---|---|:---:|---| | `grid_id` | string | yes | The grid's permanent UUID4 id. | | `body` | object | yes | ``rows`` (each maps column slug → cell value) + ``revision``; optional ``position`` / ``after_row_id`` placement. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_grids_rows_delete` @@ -619,6 +639,7 @@ A rare DELETE-with-body: ids and revision travel in the JSON body. Find row ids |---|---|:---:|---| | `grid_id` | string | yes | The grid's permanent UUID4 id. | | `body` | object | yes | ``row_ids`` to delete (at least one) + the current ``revision``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_grids_rows_move` @@ -632,6 +653,7 @@ Returns the grid's new ``revision``. |---|---|:---:|---| | `grid_id` | string | yes | The grid's permanent UUID4 id. | | `body` | object | yes | ``row_id`` (first row to move) + destination (``position`` or ``after_row_id``) + optional ``rows_count`` + the current ``revision``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_grids_columns_create` @@ -647,6 +669,7 @@ Each column needs a ``title`` and a ``type`` (``string``, ``number``, ``select`` |---|---|:---:|---| | `grid_id` | string | yes | The grid's permanent UUID4 id. | | `body` | object | yes | ``columns`` (each needs ``title`` + ``type``) + the current ``revision``; optional ``position``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_grids_columns_delete` @@ -661,6 +684,7 @@ new ``revision``. |---|---|:---:|---| | `grid_id` | string | yes | The grid's permanent UUID4 id. | | `body` | object | yes | ``column_slugs`` to delete + the current ``revision``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_grids_columns_move` @@ -674,6 +698,7 @@ Returns the grid's new ``revision``. |---|---|:---:|---| | `grid_id` | string | yes | The grid's permanent UUID4 id. | | `body` | object | yes | ``column_slug`` (first column to move) + ``position`` + optional ``columns_count`` + the current ``revision``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_grids_cells_update` @@ -688,6 +713,7 @@ plus the grid's new ``revision``. |---|---|:---:|---| | `grid_id` | string | yes | The grid's permanent UUID4 id. | | `body` | object | yes | ``cells`` (each: ``row_id`` + ``column_slug`` + ``value``) + the current ``revision``. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_grids_clone` @@ -703,6 +729,7 @@ operation reference — poll ``operations_clone_inline_grid_get`` with the retur |---|---|:---:|---| | `grid_id` | string | yes | The grid's permanent UUID4 id. | | `body` | object | yes | Clone spec: ``target`` page slug (created if absent) + optional ``title`` and ``with_data`` (copy rows too). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_grids_columns_suggest` @@ -734,6 +761,7 @@ live OpenAPI only) and may change it. | `grid_id` | string | yes | The grid's permanent UUID4 id. | | `column_slug` | string | yes | Slug of the column to edit. | | `body` | object | yes | The fields to change (``title``, ``description``, ``required``, ``width``, ``color``, ``pinned``, ``select_options``, …); ``revision`` is optional. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_grids_rows_update` @@ -751,6 +779,7 @@ change it. | `grid_id` | string | yes | The grid's permanent UUID4 id. | | `row_id` | string | yes | Id of the row to pin or colour. | | `body` | object | yes | ``pinned`` and/or ``color`` to set; ``revision`` is optional. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_operations_clone_get` @@ -820,6 +849,7 @@ pipeline in one call instead. | Parameter | Type | Required | Description | |---|---|:---:|---| | `body` | object | yes | ``file_name`` + total ``file_size`` in bytes (sum of every part). | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_uploadsessions_parts_upload` @@ -836,6 +866,7 @@ call. Returns the session (poll ``status`` via ``uploadsessions_get``). | `session_id` | string | yes | UUID4 of the upload session. | | `part_number` | integer | yes | 1-based part index (1 for the first part, +1 for each next). | | `data` | string | yes | This part's bytes, base64-encoded. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_uploadsessions_finish` @@ -849,6 +880,7 @@ session with its final ``status``. | Parameter | Type | Required | Description | |---|---|:---:|---| | `session_id` | string | yes | UUID4 of the upload session. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_uploadsessions_abort` @@ -862,6 +894,7 @@ session with ``status: aborted``. | Parameter | Type | Required | Description | |---|---|:---:|---| | `session_id` | string | yes | UUID4 of the upload session. | +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | ## `wiki_uploadsessions_abort_all` @@ -871,3 +904,7 @@ Cancel EVERY active upload session of the caller, discarding all uploaded parts. A quota-freeing sweep — use it when stale sessions block new uploads; prefer ``uploadsessions_abort`` to cancel a single known session. + +| Parameter | Type | Required | Description | +|---|---|:---:|---| +| `dry_run` | boolean | | Send nothing: answer `{dry_run: true, request}`, the first write the tool would make (null: none). | diff --git a/docs/ru/how-to/serve-the-mcp-server.md b/docs/ru/how-to/serve-the-mcp-server.md index 961af1c1..caa6dad6 100644 --- a/docs/ru/how-to/serve-the-mcp-server.md +++ b/docs/ru/how-to/serve-the-mcp-server.md @@ -35,6 +35,24 @@ ycli mcp methods --toolsets core --read-only подтверждение перед разрушающим вызовом. `--read-only` убирает все записи — для случая, когда агент ничего не должен менять. +Инструмент, который выдаёт доступ (роль, право, привязку доступа, встраивание), помечен так, что +клиент, понимающий пометку, спрашивает человека при каждом вызове; об этом сказано и в его описании. + +## Предпросмотр записи + +У каждого пишущего инструмента есть `dry_run`. С `dry_run: true` он ничего не отправляет и +возвращает запрос, который отправил бы, — тот же объект, что печатает `ycli … --dry-run -o json`, +с закрытыми секретами: + +```json +{"dry_run": true, "request": {"method": "PATCH", "url": "https://api.tracker.yandex.net/v3/issues/DE-7", "body": {"summary": "New"}}} +``` + +- То, что инструмент читает до первой записи, читается; план — только первой записи. Несколько записей делает один инструмент: `wiki_attachments_upload` показывает открытие сессии загрузки. +- `request` равен `null`, если инструмент ничего бы не записал. +- У инструмента, который только читает, `dry_run` нет: планировать нечего, аргумент получает отказ. CLI отличается: `--dry-run` — опция каждой команды, и чтение с ней уходит. +- Инструмент, выдающий доступ, спросит человека и при пробном запуске: клиент решает по инструменту, раньше чем сервер увидит аргументы. Там, где спросить некого, план даёт команда: `ycli … --dry-run`. + ## Prompts и ресурсы Кроме инструментов сервер предлагает несколько prompts и ресурсов. Клиент показывает prompt как готовый запрос (в Claude Code — `/yandex-360:tracker_issue_brief DE-7`) и позволяет прикрепить ресурс к разговору (`@yandex-360:ycli://tracker/issue/DE-7`). diff --git a/plugins/yandex-360/skills/yandex-360/SKILL.md b/plugins/yandex-360/skills/yandex-360/SKILL.md index ed1eecb6..7d35afbe 100644 --- a/plugins/yandex-360/skills/yandex-360/SKILL.md +++ b/plugins/yandex-360/skills/yandex-360/SKILL.md @@ -120,7 +120,8 @@ semantics, a service ycli does not wrap yet), read the official docs directly, a session must not write at all, run the server with `ycli mcp start --read-only`. - **CLI deletes and grants ask first** — a command that deletes data or grants access prompts on a terminal and, without one (an agent's shell), exits 2 unless given `--yes`; confirm intent with the user before - adding it. `--dry-run` prints the write request instead of sending it, the JSON result pipes + adding it. `--dry-run` prints the write request instead of sending it (a write tool takes + `dry_run: true` for the same plan), the JSON result pipes to `jq`, and the exit code says what failed (3 not found, 4 auth, 5 rate limited, 6 transient). - **A long listing comes in pieces** — a list tool returns `{items, truncated, next}`, 50 diff --git a/src/ycli/mcp/server.py b/src/ycli/mcp/server.py index 2a477009..45fa117d 100644 --- a/src/ycli/mcp/server.py +++ b/src/ycli/mcp/server.py @@ -111,6 +111,10 @@ class _Search(BM25SearchTransform): the search there is no entry, and the proxy that runs what the search found carries no mark: nobody would be asked. So a marked tool stays listed, the search does not offer it, and the proxy refuses to run it. Which tools those are is read from their mark. + + It overrides two private methods of FastMCP's transform and takes the function of its + proxy (written against FastMCP 4.0.11): the test through a real client + (``test_mcp_selection``) is what holds the behaviour when FastMCP changes them. """ async def transform_tools(self, tools: Sequence[Tool]) -> Sequence[Tool]: diff --git a/src/ycli/yandex/mcp.py b/src/ycli/yandex/mcp.py index fa4093a2..156b0cec 100644 --- a/src/ycli/yandex/mcp.py +++ b/src/ycli/yandex/mcp.py @@ -8,7 +8,10 @@ from __future__ import annotations +import logging from contextlib import contextmanager +from contextvars import ContextVar +from dataclasses import dataclass from importlib.resources import files from typing import TYPE_CHECKING, Annotated, Any @@ -17,7 +20,10 @@ from fastmcp.exceptions import ValidationError as ArgumentsRefused from fastmcp.server.dependencies import get_access_token, get_http_request from fastmcp.server.middleware import Middleware +from fastmcp.server.transforms import Transform +from fastmcp.tools.base import ToolResult from pydantic import Field, SecretStr, ValidationError +from pydantic_core import to_jsonable_python from ycli.settings import ( AppConfig, @@ -27,18 +33,21 @@ missing_credentials, ) from ycli.yandex.core.continuation import HANDLES, NOTHING_ELSE, RULE +from ycli.yandex.core.guard import Guard, PlannedRequest, RequestPlanned from ycli.yandex.errors import next_step from ycli.yandex.factory import build_client from ycli.yandex.models import field_error if TYPE_CHECKING: - from collections.abc import Callable, Iterator + from collections.abc import Callable, Iterator, Sequence from contextlib import AbstractContextManager import mcp.types as mt from fastmcp.server.auth import AuthProvider from fastmcp.server.middleware import CallNext, MiddlewareContext - from fastmcp.tools.base import ToolResult + from fastmcp.server.transforms import GetToolNext + from fastmcp.tools import Tool + from fastmcp.utilities.versions import VersionSpec from ycli.yandex.base import DomainClient @@ -237,8 +246,19 @@ def client_provider[C: DomainClient]( @contextmanager def provide() -> Iterator[C]: - with build_client(client_cls, caller_credentials(), app_config()) as client: - yield client + asked = _DRY_RUN.get() + # Under `dry_run` the client's own guard stops the first write: nothing a tool does + # with the client can send one. The call is told that its client is the guarded one. + guard = Guard(dry_run=True) if asked is not None else None + with build_client(client_cls, caller_credentials(), app_config(), guard=guard) as client: + if asked is not None: + asked.guarded = True + try: + yield client + except RequestPlanned as planned: + # The write the guard stopped is the answer of the call, not a failure of it: + # told on as an error FastMCP does not log, with no traceback of the signal. + raise _Planned(planned.plan) from None return provide @@ -293,6 +313,177 @@ async def on_call_tool( ) from None +class _Planned(ToolError): # noqa: N818 # the answer of a call, not an error of it + """A call under ``dry_run`` that reached its first write; ``plan`` is that write. + + A ``ToolError`` so that FastMCP hands it on as it is, and at a level below every level a + log is read at: a plan is what was asked for. + """ + + def __init__(self, plan: PlannedRequest) -> None: + super().__init__("planned, not sent", log_level=logging.NOTSET + 1) + self.plan = plan + + +@dataclass +class _DryRunAsked: + """One call that asked for a plan; ``guarded`` once its client was built with the guard. + + An object and not a flag: a tool that is not a coroutine runs in a thread with a copy of + the context, and what the copy is told there has to be seen here. + """ + + guarded: bool = False + + +# Set for the one call that asked for a plan, and for nothing after it. +_DRY_RUN: ContextVar[_DryRunAsked | None] = ContextVar("ycli_dry_run", default=None) +DRY_RUN = "dry_run" +#: The one description of `dry_run`, on every tool that writes. +DRY_RUN_SAID = ( + "Send nothing: answer `{dry_run: true, request}`, the first write the tool would make " + "(null: none)." +) +# FastMCP's mark of an output schema whose answer is not an object and goes under `result`. +_WRAPS = "x-fastmcp-wrap-result" +# What a tool answers under `dry_run`, beside its own answer in its output schema. +PLAN_SCHEMA: dict[str, Any] = { + "type": "object", + "properties": { + "dry_run": {"const": True}, + "request": {"type": ["object", "null"]}, + # There only when the request would grant access: such a call asks a person. + "grants_access": {"const": True}, + }, + "required": ["dry_run", "request"], + "additionalProperties": False, +} + + +def _writes(tool: Tool) -> bool: + """Whether ``tool`` says of itself that it writes: only such a tool has a plan.""" + return tool.annotations is not None and tool.annotations.read_only_hint is False + + +class DryRun(Middleware): + """Answers a tool called with ``dry_run`` by the request it would send, sending none. + + One place for every tool that writes: the argument is taken out of the call here, the + client the tool is given is built with the core's guard (:func:`client_provider`), and + the write the guard stopped is answered as the plan. A tool that only reads has no such + argument, and is told so like any argument it does not have. + + :func:`new_server` adds it to every server of ycli. + """ + + async def on_call_tool( + self, + context: MiddlewareContext[mt.CallToolRequestParams], + call_next: CallNext[mt.CallToolRequestParams, ToolResult], + ) -> ToolResult: + """The tool's result, or under ``dry_run`` the request it would have sent.""" + given = dict(context.message.arguments or {}) + inside = sorted(name for name, value in given.items() if _says_dry_run(value)) + if not (DRY_RUN in given or inside) or context.fastmcp_context is None: + return await call_next(context) + tool = await context.fastmcp_context.fastmcp.get_tool(context.message.name) + if tool is None or not _writes(tool): + return await call_next(context) # refused below as an argument it does not have + if inside: + # One who nests it believes they are planning: that must not end in a write. + raise ToolError( + f"`{DRY_RUN}` is the tool's own argument: give it beside `{inside[0]}`, " + "not inside it" + ) + asked = given.pop(DRY_RUN) + if not isinstance(asked, bool): + raise ToolError("The arguments do not fit the tool:\n dry_run: true or false") + without = context.copy(message=context.message.model_copy(update={"arguments": given})) + if not asked: + return await call_next(without) + call = _DryRunAsked() + token = _DRY_RUN.set(call) + try: + await call_next(without) + except _Planned as planned: + return _planned(planned.plan, tool) + finally: + _DRY_RUN.reset(token) + if not call.guarded: + # Its client was not the guarded one, so what it sent is not known: never a plan. + raise ToolError(f"{context.message.name} cannot be run with dry_run: it ran for real") + return _planned(None, tool) # the guard let every request through: all were reads + + +#: The argument, and the spellings of it one might write inside a body in its place. +_SPELLED = frozenset({DRY_RUN, "dryRun", "dry-run"}) + + +def _says_dry_run(value: object) -> bool: + """Whether ``value``, an argument of a call, has a key that spells ``dry_run`` at any depth.""" + if isinstance(value, dict): + return bool(_SPELLED & value.keys()) or any(map(_says_dry_run, value.values())) + return isinstance(value, list) and any(map(_says_dry_run, value)) + + +def _planned(request: PlannedRequest | None, tool: Tool) -> ToolResult: + """The plan as an answer of ``tool``, lying where the tool's own answers lie. + + Under ``result`` for a tool that answers a list, as FastMCP puts those. The request is + written out by the serializer FastMCP writes every answer with, the model's own. + """ + plan: dict[str, Any] = {DRY_RUN: True, "request": request} + if request is not None and request.grants_access: + plan["grants_access"] = True + written = to_jsonable_python(plan, by_alias=True) + wrapped = bool(tool.output_schema and tool.output_schema.get(_WRAPS)) + return ToolResult(structured_content={"result": written} if wrapped else written) + + +class DryRunOffered(Transform): + """Lists ``dry_run`` on every tool that writes, and the plan beside its own answer. + + One statement for all of them: no tool declares the argument, and none of them could + forget it. A server mounted in another passes its tools through here twice, which changes + nothing the second time. + """ + + @staticmethod + def _offered(tool: Tool) -> Tool: + if not _writes(tool) or DRY_RUN in tool.parameters.get("properties", {}): + return tool + argument = {"type": "boolean", "default": False, "description": DRY_RUN_SAID} + properties = {**tool.parameters.get("properties", {}), DRY_RUN: argument} + changed: dict[str, Any] = {"parameters": {**tool.parameters, "properties": properties}} + own = tool.output_schema + # The plan first: it is told by `dry_run: true` and takes no other key, so an answer of + # the tool is never read as one, while the tool's own models take any object. + if own is not None and own.get(_WRAPS): + answer = {"anyOf": [PLAN_SCHEMA, own["properties"]["result"]]} + changed["output_schema"] = { + **own, + "properties": {**own["properties"], "result": answer}, + } + elif own is not None: + # The definitions the tool's schema refers to stay at the root, where its + # references look for them; the plan has none of its own to clash with them. + beside = {key: value for key, value in own.items() if key != "$defs"} + defs = {"$defs": own["$defs"]} if "$defs" in own else {} + changed["output_schema"] = {"type": "object", "anyOf": [PLAN_SCHEMA, beside], **defs} + return tool.model_copy(update=changed) + + async def list_tools(self, tools: Sequence[Tool]) -> Sequence[Tool]: + """The tools, each one that writes offering ``dry_run``.""" + return [self._offered(tool) for tool in tools] + + async def get_tool( + self, name: str, call_next: GetToolNext, *, version: VersionSpec | None = None + ) -> Tool | None: + """The tool ``name``, offering ``dry_run`` when it writes.""" + tool = await call_next(name, version=version) + return None if tool is None else self._offered(tool) + + class NextSteps(Middleware): """Ends a tool's error with the next step the CLI prints under ``Hint:``. @@ -341,6 +532,8 @@ def new_server( 'forms-surveys' """ server = FastMCP(name, instructions=instructions, auth=auth) + server.add_middleware(DryRun()) server.add_middleware(ArgumentRefusals()) + server.add_transform(DryRunOffered()) server.add_middleware(NextSteps()) return server diff --git a/tests/architecture/test_conventions.py b/tests/architecture/test_conventions.py index 749d40ed..f86c9c68 100644 --- a/tests/architecture/test_conventions.py +++ b/tests/architecture/test_conventions.py @@ -16,6 +16,7 @@ from tests.architecture.scanners import GENERATED, _import_aliases, is_generated, unexplained from tests.full_server import tools_with_output_schemas from ycli.yandex.core.pagination import BodyCursorPagination +from ycli.yandex.mcp import PLAN_SCHEMA from ycli.yandex.models import ( IGNORED_BY_API, APIModel, @@ -184,7 +185,9 @@ def _undiscriminated_unions( objects = [ branch for branch in schema.get(key, []) - if "$ref" in branch or branch.get("type") == "object" + # The plan a write tool answers under `dry_run` is no member to mistake: it is + # the first, is told by `dry_run: true` and takes no other key. + if ("$ref" in branch or branch.get("type") == "object") and branch != PLAN_SCHEMA ] layer = all( branch.get("$ref", "").rsplit("/", 1)[-1] in generated for branch in objects @@ -217,6 +220,8 @@ def test_the_union_check_bites(): ] assert _undiscriminated_unions({"oneOf": members, "discriminator": {"propertyName": "t"}}) == [] assert _undiscriminated_unions({"anyOf": [{"$ref": "#/$defs/A"}, {"type": "null"}]}) == [] + assert _undiscriminated_unions({"anyOf": [PLAN_SCHEMA, {"$ref": "#/$defs/A"}]}) == [] + assert _undiscriminated_unions({"anyOf": [PLAN_SCHEMA, *members]}) == ["$"] # Both sides of the generated layer: a union of its classes alone is left to it, and one # hand-written member brings the union back under the rule. layer = frozenset({"A", "B"}) diff --git a/tests/contract/test_contract.py b/tests/contract/test_contract.py index d9347d75..57bf7167 100644 --- a/tests/contract/test_contract.py +++ b/tests/contract/test_contract.py @@ -11,6 +11,7 @@ import asyncio import json +import re from dataclasses import replace from typing import TYPE_CHECKING, Any @@ -42,6 +43,7 @@ from ycli.cli.app import app from ycli.settings import AppConfig from ycli.yandex.core.auth import IAMTokenAuth +from ycli.yandex.core.endpoint import ENDPOINT_EXTENSION, Effect from ycli.yandex.core.listing import Listing from ycli.yandex.core.resource import Resource from ycli.yandex.mcp import GRANTS_ACCESS, GRANTS_ACCESS_SAID @@ -440,3 +442,40 @@ def test_nested_command_coverage_bites(): nested = "tracker entities comments delete" gaps = coverage_gaps([case], set(), commands | {nested}, set()) assert gaps["commands without a case"] == [nested] + + +def _one_boundary(plan: object) -> object: + """``plan`` with the boundary of a file upload, drawn anew for every request, made one.""" + return json.loads(re.sub(r"boundary=[0-9a-f]+", "boundary=x", json.dumps(plan))) + + +WRITE_CASES = [ + case + for case in CASES + if case.cli is not None and case.mcp is not None and case.expected_effect != "read" +] + + +@pytest.mark.parametrize("case", WRITE_CASES, ids=[case.id for case in WRITE_CASES]) +def test_a_tool_plans_under_dry_run_what_the_command_plans(case: Case, monkeypatch, mcp_session): + """One plan on both surfaces: `--dry-run -o json` and `dry_run=true` say the same request. + + Neither sends a write: the reads a call makes before its first write are all that go out. + """ + assert case.cli is not None + assert case.mcp is not None + for name, value in case.env.items(): + monkeypatch.setenv(name, value) + api = _serve(monkeypatch, case) + printed = CliRunner().invoke(app, ["--format", "json", "--dry-run", *case.cli]) + assert printed.exit_code == 0, printed.output + by_command = api.calls[:] + api = _serve(monkeypatch, case) + name, arguments = case.mcp + answered = mcp_session.call(name, {**arguments, "dry_run": True}) + by_tool, planned = _one_boundary(answered), _one_boundary(json.loads(printed.stdout_bytes)) + # A plan that would grant access says so, where the tool is marked and nowhere else. + grants = {"grants_access": True} if _marked(mcp_session.tools[name]) else {} + assert by_tool == {"dry_run": True, "request": planned, **grants} + for sent in (*by_command, *api.calls): + assert sent.extensions[ENDPOINT_EXTENSION].effect is Effect.READ, f"sent {sent.method}" diff --git a/tests/snapshots/mcp_output_schemas.txt b/tests/snapshots/mcp_output_schemas.txt index 4f13475c..53eae2eb 100644 --- a/tests/snapshots/mcp_output_schemas.txt +++ b/tests/snapshots/mcp_output_schemas.txt @@ -1,458 +1,458 @@ datalens_audit_entries_updates_list 4f00083307d9486c datalens_audit_entry_permissions_get 48cb56a5f7693f2b datalens_charts_data_get 047419b8b58dd9c5 -datalens_charts_editor_create 4506d6e7242a0dac -datalens_charts_editor_delete 5037df4f3953d287 +datalens_charts_editor_create 4baca186262a33c6 +datalens_charts_editor_delete 0c90be01649c1ec9 datalens_charts_editor_get a42a64174ea85a70 -datalens_charts_editor_update 4506d6e7242a0dac -datalens_charts_ql_create 43c814392bdbccce -datalens_charts_ql_delete 5037df4f3953d287 +datalens_charts_editor_update 4baca186262a33c6 +datalens_charts_ql_create c52e9b4ecf1a8149 +datalens_charts_ql_delete 0c90be01649c1ec9 datalens_charts_ql_get b3a2679d856c64e1 -datalens_charts_ql_update 43c814392bdbccce -datalens_charts_wizard_create 01239de1495b9d0e -datalens_charts_wizard_delete 5037df4f3953d287 +datalens_charts_ql_update c52e9b4ecf1a8149 +datalens_charts_wizard_create 950da982ae5a98b2 +datalens_charts_wizard_delete 0c90be01649c1ec9 datalens_charts_wizard_get 8e3e11286bafcdeb -datalens_charts_wizard_update 01239de1495b9d0e -datalens_cloudenvironments_create 06911f550f05c226 -datalens_cloudenvironments_delete 06911f550f05c226 +datalens_charts_wizard_update 950da982ae5a98b2 +datalens_cloudenvironments_create f3da4e99adfe62c7 +datalens_cloudenvironments_delete f3da4e99adfe62c7 datalens_cloudenvironments_get 7249c16ae9b676f6 datalens_cloudenvironments_list f20b2ff86b293b5a -datalens_cloudenvironments_update 06911f550f05c226 +datalens_cloudenvironments_update f3da4e99adfe62c7 datalens_cloudenvironmentstorage_bucket_download_url_create 426f8a1d12ec04dc datalens_cloudenvironmentstorage_bucket_object_metadata_get 51e7cdf592e5294a datalens_cloudenvironmentstorage_bucket_objects_list 8829f34d18345d40 -datalens_cloudenvironmentstorage_bucket_upload_url_create 426f8a1d12ec04dc +datalens_cloudenvironmentstorage_bucket_upload_url_create ad56a37fe2eab2ba datalens_collections_access_bindings_list efe6a2cbc8fedd94 -datalens_collections_access_bindings_update a05d41d99e32d5bd +datalens_collections_access_bindings_update 1dc41a6f0304cf2a datalens_collections_breadcrumbs_list 6dc74cbe07e53814 datalens_collections_content_list 0c38b611a6e7f2e2 -datalens_collections_create 1d75e579be9b8b2e -datalens_collections_delete ac7f68f8925e1f5b -datalens_collections_delete_bulk ac7f68f8925e1f5b +datalens_collections_create b7e82955eece4d9e +datalens_collections_delete d00b4b12f9f3ee0a +datalens_collections_delete_bulk d00b4b12f9f3ee0a datalens_collections_get 45ebfb9e12088a89 datalens_collections_list_by_ids 4abe14fc44b29026 -datalens_collections_move 39db501a2c240826 -datalens_collections_move_bulk bb60744a5b3576cc +datalens_collections_move a0d23d79af9934c1 +datalens_collections_move_bulk 4b6148916a111eb7 datalens_collections_permissions_get_root 00314ec172fb48a0 -datalens_collections_update 39db501a2c240826 -datalens_connections_create 5f5a82682717d16d -datalens_connections_delete 5037df4f3953d287 +datalens_collections_update a0d23d79af9934c1 +datalens_connections_create f5f99b0f2d28143d +datalens_connections_delete 0c90be01649c1ec9 datalens_connections_get 291e616c93203734 -datalens_connections_update 5037df4f3953d287 -datalens_dashboards_create 5136a90f97b5abb5 -datalens_dashboards_delete 5037df4f3953d287 +datalens_connections_update 0c90be01649c1ec9 +datalens_dashboards_create 830c4459dc283e48 +datalens_dashboards_delete 0c90be01649c1ec9 datalens_dashboards_get 2918551261a5f7fc -datalens_dashboards_update 5136a90f97b5abb5 -datalens_datasets_create 532a6c24d9cee25a +datalens_dashboards_update 830c4459dc283e48 +datalens_datasets_create d8e89a9191c1ae44 datalens_datasets_data_get 4bd5e0693eb22867 -datalens_datasets_delete 5037df4f3953d287 +datalens_datasets_delete 0c90be01649c1ec9 datalens_datasets_get 532a6c24d9cee25a -datalens_datasets_update 532a6c24d9cee25a +datalens_datasets_update d8e89a9191c1ae44 datalens_datasets_validate 532a6c24d9cee25a -datalens_embeddingsecrets_create 67be3dcf886b193c -datalens_embeddingsecrets_delete 7f2bc7756d32e728 +datalens_embeddingsecrets_create c58db30cd12dddba +datalens_embeddingsecrets_delete 2d9aabd269c98efe datalens_embeddingsecrets_get 938374bdbf619d61 datalens_embeddingsecrets_list 0f8c88744c304bf2 -datalens_embeds_create 3bc50f1b54f563a2 -datalens_embeds_delete ccb6c6fd55d6da97 +datalens_embeds_create 8b044df2a36f36de +datalens_embeds_delete 3a30fcb8bfeb60be datalens_embeds_list 00e8af2f5d95154c -datalens_embeds_update 3bc50f1b54f563a2 +datalens_embeds_update 8b044df2a36f36de datalens_entries_list 0e69eb95bed26375 datalens_entries_permissions_get 4a9e7513ef7bb5d6 datalens_entries_relations_list 62a2d93e9f9e579e -datalens_entries_rename 306b22e33a5861f7 +datalens_entries_rename 195ba28ac1c33bc2 datalens_entries_revisions_list 6ecb01a9433fa5a5 -datalens_entrylocks_create c00e9338a13776a2 -datalens_entrylocks_delete 20bca3c3041f4b6b -datalens_entrylocks_extend 20bca3c3041f4b6b -datalens_htmlpages_create f733b926f849989a -datalens_htmlpages_delete 5037df4f3953d287 +datalens_entrylocks_create 7f1ceffb3b404c88 +datalens_entrylocks_delete 91d0c049ba14ec85 +datalens_entrylocks_extend 91d0c049ba14ec85 +datalens_htmlpages_create 08b18e11b4d96ef8 +datalens_htmlpages_delete 0c90be01649c1ec9 datalens_htmlpages_get 1c4de6fa2baf11f8 datalens_htmlpages_preview_url_get 9a3690858ff2baf6 -datalens_htmlpages_update 96cd102bb09e1605 +datalens_htmlpages_update 0cae8ee9b15f3c4a datalens_lakehouseoperations_get 06911f550f05c226 -datalens_licensing_licenses_assign 97664fea4f71cd68 +datalens_licensing_licenses_assign ca171f83e72ea97a datalens_licensing_licenses_list 9d86918a44a2cffe datalens_licensing_limit_get c0099f0a64bffd54 -datalens_licensing_limit_set c0099f0a64bffd54 +datalens_licensing_limit_set cb0ad9129cb40619 datalens_members_list 30b95c80d1898c88 datalens_permissions_get_bulk 8210ad89ab020789 -datalens_reports_create 4150e0fcc9b32f66 -datalens_reports_delete 5037df4f3953d287 +datalens_reports_create 7bbdd0bec7393ff1 +datalens_reports_delete 0c90be01649c1ec9 datalens_reports_get 5acbffb50a07faaf -datalens_reports_update 4dfb59e10c2fe5a2 -datalens_restcatalogs_create 06911f550f05c226 +datalens_reports_update 6fb6a656d9b55900 +datalens_restcatalogs_create f3da4e99adfe62c7 datalens_restcatalogs_list 0a6fd9b2f3c60926 datalens_sharedentries_access_bindings_list efe6a2cbc8fedd94 -datalens_sharedentries_access_bindings_update a05d41d99e32d5bd -datalens_sparkapplications_cancel 06911f550f05c226 -datalens_sparkapplications_create 06911f550f05c226 +datalens_sharedentries_access_bindings_update 1dc41a6f0304cf2a +datalens_sparkapplications_cancel f3da4e99adfe62c7 +datalens_sparkapplications_create f3da4e99adfe62c7 datalens_sparkapplications_get 6eb33934ecab67e1 datalens_sparkapplications_list 07f9578615ec43e7 datalens_sparkapplications_log_list 1f6a76dc32645260 -datalens_sparkclusters_create 06911f550f05c226 -datalens_sparkclusters_delete 06911f550f05c226 +datalens_sparkclusters_create f3da4e99adfe62c7 +datalens_sparkclusters_delete f3da4e99adfe62c7 datalens_sparkclusters_get 94f0b02fca34ddac datalens_sparkclusters_list e2370093eee8bbcb datalens_sparkclusters_resource_presets_get 0000db7e43eee305 datalens_sparkclusters_resource_presets_list f2d020bae315a9f8 -datalens_sparkclusters_start 06911f550f05c226 -datalens_sparkclusters_stop 06911f550f05c226 -datalens_sqlqueries_create bf6e117720108299 -datalens_sqlqueries_delete 5037df4f3953d287 +datalens_sparkclusters_start f3da4e99adfe62c7 +datalens_sparkclusters_stop f3da4e99adfe62c7 +datalens_sqlqueries_create 2794165f69d6590e +datalens_sqlqueries_delete 0c90be01649c1ec9 datalens_sqlqueries_get abcbed0bd5c88d9c -datalens_sqlqueries_run 52233e50814e4d67 -datalens_sqlqueries_update bf6e117720108299 +datalens_sqlqueries_run 86d35552c46b3c26 +datalens_sqlqueries_update 2794165f69d6590e datalens_tenant_details_get 7cacbce0fd0b5234 -datalens_trinoclusters_catalog_create 06911f550f05c226 -datalens_trinoclusters_catalog_delete 06911f550f05c226 -datalens_trinoclusters_create 06911f550f05c226 -datalens_trinoclusters_delete 06911f550f05c226 +datalens_trinoclusters_catalog_create f3da4e99adfe62c7 +datalens_trinoclusters_catalog_delete f3da4e99adfe62c7 +datalens_trinoclusters_create f3da4e99adfe62c7 +datalens_trinoclusters_delete f3da4e99adfe62c7 datalens_trinoclusters_get ad346fe86374e284 datalens_trinoclusters_list 207be0e886fda877 datalens_trinoclusters_resource_preset_get 0000db7e43eee305 datalens_trinoclusters_resource_presets_list 4d3d72475ba37b80 -datalens_trinoclusters_start 06911f550f05c226 -datalens_trinoclusters_stop 06911f550f05c226 -datalens_workbookexports_cancel 0407e3403c397cfd +datalens_trinoclusters_start f3da4e99adfe62c7 +datalens_trinoclusters_stop f3da4e99adfe62c7 +datalens_workbookexports_cancel 00f1594662dd0381 datalens_workbookexports_result_get 1a2eb17f98014b64 -datalens_workbookexports_start f11b67adb28f16c3 +datalens_workbookexports_start ed05ebd4abd9d308 datalens_workbookexports_status_get 2e9ee2bb676bb557 -datalens_workbookimports_start 084f39828251377c +datalens_workbookimports_start d03afe0e5359bcac datalens_workbookimports_status_get b16935912d510c01 datalens_workbooks_access_bindings_list efe6a2cbc8fedd94 -datalens_workbooks_access_bindings_update a05d41d99e32d5bd -datalens_workbooks_create 4757e55992ae8852 -datalens_workbooks_delete 6dafbdef3fd221b1 -datalens_workbooks_delete_bulk a85dde78fdd84227 +datalens_workbooks_access_bindings_update 1dc41a6f0304cf2a +datalens_workbooks_create 78f9fe7217ff8f6f +datalens_workbooks_delete 64aa41c9d7fb3116 +datalens_workbooks_delete_bulk c56049b629da1192 datalens_workbooks_entries_list 8af45be5c1ab48b3 datalens_workbooks_get d0e3e93c81b23242 datalens_workbooks_list e35a9eb7400958a4 datalens_workbooks_list_by_ids 29bc34f05555330a -datalens_workbooks_move 6dafbdef3fd221b1 -datalens_workbooks_move_bulk 9b53ddea339bab4b -datalens_workbooks_update 6dafbdef3fd221b1 -forms_access_grant f3b96b4ea415f565 +datalens_workbooks_move 64aa41c9d7fb3116 +datalens_workbooks_move_bulk d6c99623a572a96f +datalens_workbooks_update 64aa41c9d7fb3116 +forms_access_grant 1ab1890f27abdbb5 forms_access_list f3b96b4ea415f565 -forms_access_revoke f3b96b4ea415f565 -forms_access_update f3b96b4ea415f565 +forms_access_revoke 1ab1890f27abdbb5 +forms_access_update 1ab1890f27abdbb5 forms_answers_columns_list acef33813751203e -forms_answers_delete 5037df4f3953d287 -forms_answers_export 960968a8ff927610 +forms_answers_delete 0c90be01649c1ec9 +forms_answers_export 57229efb8a7c0a9d forms_answers_get 018c88b46dc62547 forms_answers_integrations_list f5e22d8a55fb109f forms_answers_list 48e7d1be7dc8c061 -forms_answers_restore 5037df4f3953d287 -forms_conditions_hook_create f041d92f27feb05a -forms_conditions_hook_delete 5037df4f3953d287 +forms_answers_restore 0c90be01649c1ec9 +forms_conditions_hook_create 085a34bdbcaf963e +forms_conditions_hook_delete 0c90be01649c1ec9 forms_conditions_hook_get f041d92f27feb05a forms_conditions_hook_list 3b3f5e230b59e5af -forms_conditions_hook_update f041d92f27feb05a -forms_conditions_hook_update_operator 3b3f5e230b59e5af -forms_conditions_page_create f041d92f27feb05a -forms_conditions_page_delete 5037df4f3953d287 +forms_conditions_hook_update 085a34bdbcaf963e +forms_conditions_hook_update_operator 47c372b413c7408f +forms_conditions_page_create 085a34bdbcaf963e +forms_conditions_page_delete 0c90be01649c1ec9 forms_conditions_page_get f041d92f27feb05a forms_conditions_page_list 3b3f5e230b59e5af -forms_conditions_page_update f041d92f27feb05a -forms_conditions_page_update_operator 3b3f5e230b59e5af -forms_conditions_question_create f041d92f27feb05a -forms_conditions_question_delete 5037df4f3953d287 +forms_conditions_page_update 085a34bdbcaf963e +forms_conditions_page_update_operator 47c372b413c7408f +forms_conditions_question_create 085a34bdbcaf963e +forms_conditions_question_delete 0c90be01649c1ec9 forms_conditions_question_get f041d92f27feb05a forms_conditions_question_list 3b3f5e230b59e5af -forms_conditions_question_update f041d92f27feb05a -forms_conditions_question_update_operator 3b3f5e230b59e5af -forms_conditions_submit_create f041d92f27feb05a -forms_conditions_submit_delete 5037df4f3953d287 +forms_conditions_question_update 085a34bdbcaf963e +forms_conditions_question_update_operator 47c372b413c7408f +forms_conditions_submit_create 085a34bdbcaf963e +forms_conditions_submit_delete 0c90be01649c1ec9 forms_conditions_submit_get f041d92f27feb05a forms_conditions_submit_list 3b3f5e230b59e5af -forms_conditions_submit_update f041d92f27feb05a -forms_conditions_submit_update_operator 3b3f5e230b59e5af -forms_files_delete 5037df4f3953d287 +forms_conditions_submit_update 085a34bdbcaf963e +forms_conditions_submit_update_operator 47c372b413c7408f +forms_files_delete 0c90be01649c1ec9 forms_files_verify 92e3d07d12c48bb6 forms_filling_get c40d2baa1ae3f480 -forms_filling_submit 4b4308b51d275d89 +forms_filling_submit f7f56fd6cdc635b6 forms_filling_suggest 1755fd83ba8af6e6 forms_history_list 5ad9e9a88e87b1f7 -forms_hooks_create 7c7c863c54700914 -forms_hooks_delete 5037df4f3953d287 +forms_hooks_create 0017b466d502977c +forms_hooks_delete 0c90be01649c1ec9 forms_hooks_get 7c7c863c54700914 forms_hooks_list 92958d7ef59fffc8 -forms_hooks_update 7c7c863c54700914 -forms_images_clone 5dc29c7719de4ef6 -forms_keysets_create 8aa68ba531b53e6c -forms_keysets_delete 5037df4f3953d287 +forms_hooks_update 0017b466d502977c +forms_images_clone 563f8149cd48af41 +forms_keysets_create 5b22c83c5a8ab05c +forms_keysets_delete 0c90be01649c1ec9 forms_keysets_get 8aa68ba531b53e6c forms_keysets_list 2a668a9b1154397f -forms_keysets_update 8aa68ba531b53e6c +forms_keysets_update 5b22c83c5a8ab05c forms_me_get c490719d92aa073e -forms_notifications_cancel 5bc539a006c24e15 +forms_notifications_cancel 2f4a7e8f385c1053 forms_notifications_errors_list 6cb6e1912d8ff159 forms_notifications_get 7771c66bd909f26e forms_notifications_list d79b84bf2339dd8a -forms_notifications_restart 5bc539a006c24e15 +forms_notifications_restart 2f4a7e8f385c1053 forms_notifications_status_get 6d0e3f6ad3933be5 forms_operations_get 960968a8ff927610 -forms_questions_create 34bcc7c5dd6079d5 -forms_questions_delete 5037df4f3953d287 +forms_questions_create 7c0c514e6bda7a38 +forms_questions_delete 0c90be01649c1ec9 forms_questions_get 34bcc7c5dd6079d5 forms_questions_list 6cdbb6bca1a19acb -forms_questions_move 92a9c3b77a31bb2d -forms_questions_update 34bcc7c5dd6079d5 -forms_subscriptions_create c7fcca70f2b107cb -forms_subscriptions_delete 5037df4f3953d287 +forms_questions_move f24f3bb9562dce51 +forms_questions_update 7c0c514e6bda7a38 +forms_subscriptions_create 6f07561af22c5fd0 +forms_subscriptions_delete 0c90be01649c1ec9 forms_subscriptions_get c7fcca70f2b107cb forms_subscriptions_list d7a76b203e8a67d6 -forms_subscriptions_update c7fcca70f2b107cb -forms_surveys_create f570d2dacaf1eca6 -forms_surveys_delete 5037df4f3953d287 +forms_subscriptions_update 6f07561af22c5fd0 +forms_surveys_create a0106e49de5b8315 +forms_surveys_delete 0c90be01649c1ec9 forms_surveys_get f570d2dacaf1eca6 forms_surveys_list 941b21cd733ac9d8 -forms_surveys_publish 5037df4f3953d287 -forms_surveys_unpublish 5037df4f3953d287 -forms_surveys_update f570d2dacaf1eca6 +forms_surveys_publish 0c90be01649c1ec9 +forms_surveys_unpublish 0c90be01649c1ec9 +forms_surveys_update a0106e49de5b8315 forms_variables_list 927ea81fd7eb1dc2 schema_get 02d45df59a7c9f4e status_get 9e6b9e28b0a949e4 tracker_applications_list 30142cd9e25f3353 -tracker_attachments_delete 5037df4f3953d287 +tracker_attachments_delete 0c90be01649c1ec9 tracker_attachments_get 9caa460bea26e5fc -tracker_attachments_import 9caa460bea26e5fc +tracker_attachments_import b9550cb2073aaadb tracker_attachments_list 09d19a220c1a11b3 -tracker_attachments_upload 9caa460bea26e5fc -tracker_attachments_upload_temp 9caa460bea26e5fc -tracker_autoactions_create e6f4ae46fe860041 +tracker_attachments_upload b9550cb2073aaadb +tracker_attachments_upload_temp b9550cb2073aaadb +tracker_autoactions_create 738d8d0256498a5d tracker_autoactions_get e6f4ae46fe860041 tracker_autoactions_logs_get 917a71e454104f78 tracker_autoactions_logs_list f07a36f474b1910c -tracker_boards_create 02a7c6e4432ccbb8 -tracker_boards_delete 5037df4f3953d287 +tracker_boards_create c63f295ab1dec526 +tracker_boards_delete 0c90be01649c1ec9 tracker_boards_get 02a7c6e4432ccbb8 tracker_boards_list c724ddd38bebcc90 -tracker_boards_update 02a7c6e4432ccbb8 +tracker_boards_update c63f295ab1dec526 tracker_bulk_get b7b283ab25bfc9f9 tracker_bulk_issues_list 112ab4bdae26fe0f tracker_changelog_list beeeeb68feadfa50 -tracker_checklists_clear 6ff5fc21232e06eb -tracker_checklists_create 6ff5fc21232e06eb -tracker_checklists_delete 6ff5fc21232e06eb +tracker_checklists_clear f369ede09a82f821 +tracker_checklists_create f369ede09a82f821 +tracker_checklists_delete f369ede09a82f821 tracker_checklists_list 384503792482e6d2 -tracker_checklists_update 6ff5fc21232e06eb -tracker_columns_create 09d10f21091a183f -tracker_columns_delete 5037df4f3953d287 +tracker_checklists_update f369ede09a82f821 +tracker_columns_create 8f96a6085b2c346e +tracker_columns_delete 0c90be01649c1ec9 tracker_columns_get 09d10f21091a183f tracker_columns_list 7690e339f92058dd -tracker_columns_update 09d10f21091a183f -tracker_comments_create d31f98a2f35dc412 -tracker_comments_delete 5037df4f3953d287 +tracker_columns_update 8f96a6085b2c346e +tracker_comments_create c8fc4e94a0c2407e +tracker_comments_delete 0c90be01649c1ec9 tracker_comments_get d31f98a2f35dc412 -tracker_comments_import d31f98a2f35dc412 +tracker_comments_import c8fc4e94a0c2407e tracker_comments_list d7a27e7e0dc6fd87 -tracker_comments_reactions_create d31f98a2f35dc412 -tracker_comments_update d31f98a2f35dc412 -tracker_components_create 3f1a079188c9a167 -tracker_components_delete 5037df4f3953d287 +tracker_comments_reactions_create c8fc4e94a0c2407e +tracker_comments_update c8fc4e94a0c2407e +tracker_components_create 2c1803c9b7010c01 +tracker_components_delete 0c90be01649c1ec9 tracker_components_get 3f1a079188c9a167 tracker_components_group_permissions_get 917fcf89ce5954b3 tracker_components_list 67fd7b4ab06d9ea4 tracker_components_list_for_queue 67fd7b4ab06d9ea4 -tracker_components_update 3f1a079188c9a167 +tracker_components_update 2c1803c9b7010c01 tracker_components_user_permissions_get 91eba36f6a7d3730 -tracker_dashboards_create bc901b5539dd81df -tracker_dashboards_widgets_create_cycle_time 1209e75dfb3a107d -tracker_entities_attachments_attach 0b5f6f718f67e86e -tracker_entities_attachments_delete 5037df4f3953d287 +tracker_dashboards_create 669543fc1c75980c +tracker_dashboards_widgets_create_cycle_time 31a3a8d518a972a6 +tracker_entities_attachments_attach 70f6be4a4eecae65 +tracker_entities_attachments_delete 0c90be01649c1ec9 tracker_entities_attachments_get a73ce1b2270b74c9 tracker_entities_attachments_list 1790366b870a2bf3 tracker_entities_bulk_get 8e1178572364c447 -tracker_entities_checklists_create 0b5f6f718f67e86e -tracker_entities_checklists_delete 0b5f6f718f67e86e -tracker_entities_checklists_items_delete 0b5f6f718f67e86e -tracker_entities_checklists_items_update 0b5f6f718f67e86e -tracker_entities_checklists_move 0b5f6f718f67e86e -tracker_entities_checklists_update 0b5f6f718f67e86e -tracker_entities_comments_create 76c930f83ab389e8 -tracker_entities_comments_delete 5037df4f3953d287 +tracker_entities_checklists_create 70f6be4a4eecae65 +tracker_entities_checklists_delete 70f6be4a4eecae65 +tracker_entities_checklists_items_delete 70f6be4a4eecae65 +tracker_entities_checklists_items_update 70f6be4a4eecae65 +tracker_entities_checklists_move 70f6be4a4eecae65 +tracker_entities_checklists_update 70f6be4a4eecae65 +tracker_entities_comments_create f8d3733eb7337fa9 +tracker_entities_comments_delete 0c90be01649c1ec9 tracker_entities_comments_get 76c930f83ab389e8 tracker_entities_comments_list 790f12283d3a13db tracker_entities_comments_list_relative 9c2cde0065757dc5 -tracker_entities_comments_update 76c930f83ab389e8 -tracker_entities_create 0b5f6f718f67e86e -tracker_entities_delete 5037df4f3953d287 +tracker_entities_comments_update f8d3733eb7337fa9 +tracker_entities_create 70f6be4a4eecae65 +tracker_entities_delete 0c90be01649c1ec9 tracker_entities_events_list f8972edc914dd5c1 tracker_entities_get 0b5f6f718f67e86e -tracker_entities_links_create 5037df4f3953d287 -tracker_entities_links_delete 5037df4f3953d287 +tracker_entities_links_create 0c90be01649c1ec9 +tracker_entities_links_delete 0c90be01649c1ec9 tracker_entities_links_list 836f3e30bedde5d2 tracker_entities_permissions_get d752b907c1627223 tracker_entities_permissions_get_direct ab8d2e5b8f440a6f -tracker_entities_permissions_update d752b907c1627223 -tracker_entities_permissions_update_direct ab8d2e5b8f440a6f -tracker_entities_reports_create 0b5f6f718f67e86e +tracker_entities_permissions_update a5fd9d9b0a714bbe +tracker_entities_permissions_update_direct 612ffd9b7a682ee1 +tracker_entities_reports_create 70f6be4a4eecae65 tracker_entities_search c1de0da872c7eb1f -tracker_entities_update 0b5f6f718f67e86e -tracker_entities_update_bulk 8e1178572364c447 -tracker_fields_categories_create 3afb57090b746e9c -tracker_fields_categories_update 3afb57090b746e9c -tracker_fields_create 63d2e98e192e115e +tracker_entities_update 70f6be4a4eecae65 +tracker_entities_update_bulk baa4bde2d5c974f5 +tracker_fields_categories_create 887bf44f5ff6d892 +tracker_fields_categories_update 887bf44f5ff6d892 +tracker_fields_create a294654e36736945 tracker_fields_get 63d2e98e192e115e tracker_fields_list 146598bda7270c07 -tracker_fields_update 63d2e98e192e115e -tracker_filters_create 7555286825c3957c -tracker_filters_delete 5037df4f3953d287 +tracker_fields_update a294654e36736945 +tracker_filters_create 3a73f25fb82c180c +tracker_filters_delete 0c90be01649c1ec9 tracker_filters_get 7555286825c3957c -tracker_filters_update 7555286825c3957c -tracker_gaps_create 22d47481b2c2b1e3 -tracker_gaps_delete 5037df4f3953d287 +tracker_filters_update 3a73f25fb82c180c +tracker_gaps_create 03845f3f7931058a +tracker_gaps_delete 0c90be01649c1ec9 tracker_gaps_search 563bea7d463212f9 tracker_issues_count d1b083c4a19dd378 -tracker_issues_create 6ff5fc21232e06eb +tracker_issues_create f369ede09a82f821 tracker_issues_get 6ff5fc21232e06eb -tracker_issues_import 6ff5fc21232e06eb +tracker_issues_import f369ede09a82f821 tracker_issues_list f3391111878ebde9 -tracker_issues_move 6ff5fc21232e06eb -tracker_issues_move_bulk b7b283ab25bfc9f9 -tracker_issues_scroll_clear 5037df4f3953d287 +tracker_issues_move f369ede09a82f821 +tracker_issues_move_bulk 699b2ad227031882 +tracker_issues_scroll_clear 0c90be01649c1ec9 tracker_issues_search f3391111878ebde9 tracker_issues_suggest a9018b38fcc0b138 -tracker_issues_transition_bulk b7b283ab25bfc9f9 -tracker_issues_update 6ff5fc21232e06eb -tracker_issues_update_bulk b7b283ab25bfc9f9 -tracker_issuetypes_create 69db85b87b61cde0 +tracker_issues_transition_bulk 699b2ad227031882 +tracker_issues_update f369ede09a82f821 +tracker_issues_update_bulk 699b2ad227031882 +tracker_issuetypes_create ab574047235cca1f tracker_issuetypes_list 8735c42c9508872a -tracker_issuetypes_update 69db85b87b61cde0 -tracker_links_create a49b69b3d60ecc92 -tracker_links_delete 5037df4f3953d287 -tracker_links_import a49b69b3d60ecc92 +tracker_issuetypes_update ab574047235cca1f +tracker_links_create 9df0c5e013ec50b8 +tracker_links_delete 0c90be01649c1ec9 +tracker_links_import 9df0c5e013ec50b8 tracker_links_list 08b58467e8f2179b tracker_links_list_filtered e56a39ac77b8b4cd tracker_linktypes_list 35b89bbe462b9318 -tracker_localfields_create 8467dd10883c1462 +tracker_localfields_create 55cbd229e3ea4ece tracker_localfields_get 8467dd10883c1462 tracker_localfields_list 9caa04e6a5e1aabc -tracker_localfields_update 8467dd10883c1462 -tracker_macros_create 3e2f9532b59c163c -tracker_macros_delete 5037df4f3953d287 +tracker_localfields_update 55cbd229e3ea4ece +tracker_macros_create 9f82b9a574f09490 +tracker_macros_delete 0c90be01649c1ec9 tracker_macros_get 3e2f9532b59c163c tracker_macros_list 9c2a97b77557d578 -tracker_macros_update 3e2f9532b59c163c +tracker_macros_update 9f82b9a574f09490 tracker_me_get c7cd8c6a36625adc -tracker_priorities_create 4f43af3af64a664b +tracker_priorities_create 5827942d0049a68e tracker_priorities_list 927abe88b10870e1 -tracker_priorities_update 4f43af3af64a664b -tracker_projects_create 13854f96acfc84f2 -tracker_projects_delete 5037df4f3953d287 +tracker_priorities_update 5827942d0049a68e +tracker_projects_create 63123cf108ea59fc +tracker_projects_delete 0c90be01649c1ec9 tracker_projects_get 13854f96acfc84f2 tracker_projects_list 005949abed6c2e85 tracker_projects_queues_list d90e0494e1c07f34 -tracker_projects_update 13854f96acfc84f2 -tracker_queues_create b116417ec66ef7a3 -tracker_queues_delete 5037df4f3953d287 +tracker_projects_update 63123cf108ea59fc +tracker_queues_create 76b3f2d01c8a731c +tracker_queues_delete 0c90be01649c1ec9 tracker_queues_fields_list 50e806b41cf44985 tracker_queues_get b116417ec66ef7a3 tracker_queues_group_permissions_get 649f21c3ba1f3a9c tracker_queues_list ca869a43a19617dc -tracker_queues_permissions_update 4335169366707d16 -tracker_queues_restore b116417ec66ef7a3 -tracker_queues_tags_delete 5037df4f3953d287 +tracker_queues_permissions_update 36ca8edc85b4727e +tracker_queues_restore 76b3f2d01c8a731c +tracker_queues_tags_delete 0c90be01649c1ec9 tracker_queues_tags_list 1b1074db242ec2b7 tracker_queues_user_permissions_get f2e0c815e995f5f5 -tracker_queues_versions_create 429f2f6aa7f8a39d -tracker_queues_versions_delete 5037df4f3953d287 +tracker_queues_versions_create dfc0b32c63a1af38 +tracker_queues_versions_delete 0c90be01649c1ec9 tracker_queues_versions_get 429f2f6aa7f8a39d tracker_queues_versions_list 1f5e1738b4c8de04 -tracker_queues_versions_update 429f2f6aa7f8a39d -tracker_remotelinks_create 2b02271b8c02132a -tracker_remotelinks_delete 5037df4f3953d287 +tracker_queues_versions_update dfc0b32c63a1af38 +tracker_remotelinks_create 515cbce1bf1d4805 +tracker_remotelinks_delete 0c90be01649c1ec9 tracker_remotelinks_list 2f481b3652568330 -tracker_resolutions_create ad8f6c189dd746cb +tracker_resolutions_create 4ab9962c7cf7fb83 tracker_resolutions_list 40bf2d8233ff1bd3 -tracker_resolutions_update ad8f6c189dd746cb -tracker_sprints_archive b09d6006d9b7b28a -tracker_sprints_create b09d6006d9b7b28a -tracker_sprints_delete 5037df4f3953d287 +tracker_resolutions_update 4ab9962c7cf7fb83 +tracker_sprints_archive 904ce5a33b3ef0ec +tracker_sprints_create 904ce5a33b3ef0ec +tracker_sprints_delete 0c90be01649c1ec9 tracker_sprints_get b09d6006d9b7b28a tracker_sprints_list eeb2543089ca8a5b -tracker_sprints_start b09d6006d9b7b28a -tracker_sprints_update b09d6006d9b7b28a -tracker_statuses_create bb06dcc28738c1ae +tracker_sprints_start 904ce5a33b3ef0ec +tracker_sprints_update 904ce5a33b3ef0ec +tracker_statuses_create 726bd8a1a8f522c1 tracker_statuses_list 9534ed2baeb3c301 -tracker_statuses_update bb06dcc28738c1ae -tracker_transitions_execute 514cc8d974d11ea2 +tracker_statuses_update 726bd8a1a8f522c1 +tracker_transitions_execute 3f88d3321b0a1679 tracker_transitions_list 514cc8d974d11ea2 -tracker_triggers_create 5c73f01f3a2de00b +tracker_triggers_create 01ba2a0f3fdb6be6 tracker_triggers_get 5c73f01f3a2de00b tracker_triggers_list 9d4e8da2b52b046e -tracker_triggers_update 5c73f01f3a2de00b +tracker_triggers_update 01ba2a0f3fdb6be6 tracker_triggers_webhook_log_list 8858156726c83421 tracker_users_get 56b4b47cdf299353 tracker_users_list de7def6fe6e7d1f2 -tracker_workflows_actions_update ba1f999a6cd60257 -tracker_workflows_create ba1f999a6cd60257 -tracker_workflows_delete 5037df4f3953d287 +tracker_workflows_actions_update c7a0a8236ab2a186 +tracker_workflows_create c7a0a8236ab2a186 +tracker_workflows_delete 0c90be01649c1ec9 tracker_workflows_get ba1f999a6cd60257 tracker_workflows_list 7002037c4f85ac99 tracker_workflows_list_for_queue 438fc8d17632daac -tracker_workflows_update ba1f999a6cd60257 -tracker_worklog_create 8dfbfb78256a549f -tracker_worklog_delete 5037df4f3953d287 -tracker_worklog_import 2013da5186a83049 +tracker_workflows_update c7a0a8236ab2a186 +tracker_worklog_create 629d46c81993df90 +tracker_worklog_delete 0c90be01649c1ec9 +tracker_worklog_import 187759184ff9b44d tracker_worklog_list 7a8b97e67347e10f tracker_worklog_list_global 2013da5186a83049 tracker_worklog_search 2013da5186a83049 -tracker_worklog_update 8dfbfb78256a549f -wiki_access_clear 5037df4f3953d287 -wiki_access_create 71402ef92acaf83d -wiki_access_delete 5037df4f3953d287 -wiki_access_update 71402ef92acaf83d -wiki_attachments_attach 3e2e6227667ad737 -wiki_attachments_delete 5037df4f3953d287 +tracker_worklog_update 629d46c81993df90 +wiki_access_clear 0c90be01649c1ec9 +wiki_access_create 77ebfbf9fc338d87 +wiki_access_delete 0c90be01649c1ec9 +wiki_access_update 77ebfbf9fc338d87 +wiki_attachments_attach 5e846c209476e140 +wiki_attachments_delete 0c90be01649c1ec9 wiki_attachments_get 7eba58c374b1b5a6 wiki_attachments_list 72533f916e1c2d77 -wiki_attachments_upload 3e2e6227667ad737 -wiki_comments_create 350457b6c22c49db -wiki_comments_delete 70bd7b4a05689dcc +wiki_attachments_upload 5e846c209476e140 +wiki_comments_create f52a0caa0e7e7ddc +wiki_comments_delete 3a7f7571c66ce7c4 wiki_comments_list 6f21697ec5d690b0 wiki_comments_thread_get 6f21697ec5d690b0 wiki_comments_thread_list 0f67108ef940592e -wiki_grids_cells_update ec0bd13195733795 -wiki_grids_clone 5e55a0428f2f9a6b -wiki_grids_columns_create 12430ceb1183613b -wiki_grids_columns_delete 12430ceb1183613b -wiki_grids_columns_move 12430ceb1183613b +wiki_grids_cells_update e6b9c0c0cc657bea +wiki_grids_clone 0dba8fc6b900e178 +wiki_grids_columns_create 754a6606d41b47db +wiki_grids_columns_delete 754a6606d41b47db +wiki_grids_columns_move 754a6606d41b47db wiki_grids_columns_suggest 2c10e0fca725f659 -wiki_grids_columns_update c92e270cc08b1a1f -wiki_grids_create e8996cb73bc0e177 -wiki_grids_delete 5037df4f3953d287 +wiki_grids_columns_update 14734460d6563f37 +wiki_grids_create 91104b0d3ff5a3ab +wiki_grids_delete 0c90be01649c1ec9 wiki_grids_get e8996cb73bc0e177 -wiki_grids_rows_create 3c7ac7218c47a891 -wiki_grids_rows_delete 12430ceb1183613b -wiki_grids_rows_move 12430ceb1183613b -wiki_grids_rows_update bc08b7a62976eac3 -wiki_grids_update 12430ceb1183613b +wiki_grids_rows_create 0aa75c95a6a1f2a5 +wiki_grids_rows_delete 754a6606d41b47db +wiki_grids_rows_move 754a6606d41b47db +wiki_grids_rows_update 1c10d5634a36a027 +wiki_grids_update 754a6606d41b47db wiki_me_get 8f463f3974eac244 wiki_operations_clone_get 07d9d76544a946e2 wiki_operations_clone_inline_grid_get 0f6deda0ccc35072 wiki_operations_move_get 71901592a1cd6f98 -wiki_pages_append ab838c875a434800 +wiki_pages_append 7a343fa5958544eb wiki_pages_backlinks_list fedd105829ecea66 -wiki_pages_clone 5e55a0428f2f9a6b -wiki_pages_create ab838c875a434800 -wiki_pages_delete b03a3921720f4e47 +wiki_pages_clone 0dba8fc6b900e178 +wiki_pages_create 7a343fa5958544eb +wiki_pages_delete 1e81f0791543909b wiki_pages_descendants_list fedd105829ecea66 wiki_pages_descendants_list_by_id fedd105829ecea66 wiki_pages_get 9251638f5376748b wiki_pages_get_by_id ab838c875a434800 wiki_pages_get_meta ab838c875a434800 wiki_pages_grids_list cec28214668b77ba -wiki_pages_move 5e55a0428f2f9a6b +wiki_pages_move 0dba8fc6b900e178 wiki_pages_revisions_list 39c0545628affb55 wiki_pages_search 68cddaa767e5717f -wiki_pages_update ab838c875a434800 -wiki_recovery_recover b1874e0265629ce7 +wiki_pages_update 7a343fa5958544eb +wiki_recovery_recover a16928d1afbfc689 wiki_resources_list 99f14feb8c117ddb -wiki_uploadsessions_abort e243dc895fa657e6 -wiki_uploadsessions_abort_all 6f9113388d03ec1d -wiki_uploadsessions_create e243dc895fa657e6 -wiki_uploadsessions_finish e243dc895fa657e6 +wiki_uploadsessions_abort 4a4e8f2a1945e92f +wiki_uploadsessions_abort_all 67776442dc9ace9e +wiki_uploadsessions_create 4a4e8f2a1945e92f +wiki_uploadsessions_finish 4a4e8f2a1945e92f wiki_uploadsessions_get e243dc895fa657e6 -wiki_uploadsessions_parts_upload e243dc895fa657e6 +wiki_uploadsessions_parts_upload 4a4e8f2a1945e92f diff --git a/tests/snapshots/mcp_signatures.txt b/tests/snapshots/mcp_signatures.txt index 9638eae5..79feecba 100644 --- a/tests/snapshots/mcp_signatures.txt +++ b/tests/snapshots/mcp_signatures.txt @@ -1,458 +1,458 @@ datalens_audit_entries_updates_list(all:boolean=False, from_:string!, limit:integer|null=None, next:string|null=None, to:string|null=None) datalens_audit_entry_permissions_get(entry_ids:array!, user_id:string!) datalens_charts_data_get(chart_id:string!, params:object|null=None) -datalens_charts_editor_create(entry:object|object|object|object|object|object!) -datalens_charts_editor_delete(chart_id:string!) +datalens_charts_editor_create(dry_run:boolean=False, entry:object|object|object|object|object|object!) +datalens_charts_editor_delete(chart_id:string!, dry_run:boolean=False) datalens_charts_editor_get(branch:string|string|null=None, chart_id:string!, include_favorite:boolean|null=None, include_links:boolean|null=None, include_permissions:boolean|null=None, rev_id:string|null=None, workbook_id:string|null=None) -datalens_charts_editor_update(entry:object|object|object|object|object|object!, mode:string|string!) -datalens_charts_ql_create(annotation:object|null=None, data:object!, key:string|null=None, name:string|null=None, template:string!, workbook_id:string|null=None) -datalens_charts_ql_delete(chart_id:string!) +datalens_charts_editor_update(dry_run:boolean=False, entry:object|object|object|object|object|object!, mode:string|string!) +datalens_charts_ql_create(annotation:object|null=None, data:object!, dry_run:boolean=False, key:string|null=None, name:string|null=None, template:string!, workbook_id:string|null=None) +datalens_charts_ql_delete(chart_id:string!, dry_run:boolean=False) datalens_charts_ql_get(branch:string|string|null=None, chart_id:string!, include_favorite:boolean|null=None, include_links:boolean|null=None, include_permissions:boolean|null=None, rev_id:string|null=None, workbook_id:string|null=None) -datalens_charts_ql_update(annotation:object|null=None, data:object!, entry_id:string!, mode:string|string!, template:string!) -datalens_charts_wizard_create(annotation:object|null=None, data:object!, key:string|null=None, name:string|null=None, workbook_id:string|null=None) -datalens_charts_wizard_delete(chart_id:string!) +datalens_charts_ql_update(annotation:object|null=None, data:object!, dry_run:boolean=False, entry_id:string!, mode:string|string!, template:string!) +datalens_charts_wizard_create(annotation:object|null=None, data:object!, dry_run:boolean=False, key:string|null=None, name:string|null=None, workbook_id:string|null=None) +datalens_charts_wizard_delete(chart_id:string!, dry_run:boolean=False) datalens_charts_wizard_get(branch:string|string|null=None, chart_id:string!, include_favorite:boolean|null=None, include_links:boolean|null=None, include_permissions:boolean|null=None, rev_id:string|null=None, workbook_id:string|null=None) -datalens_charts_wizard_update(annotation:object|null=None, chart_id:string!, data:object!, mode:string|string!, rev_id:string|null=None) -datalens_cloudenvironments_create(cloud_id:string!, description:string|null=None, name:string!, security_group_ids:array|null=None, storage:object|null=None, subnet_id:string!) -datalens_cloudenvironments_delete(id:string!) +datalens_charts_wizard_update(annotation:object|null=None, chart_id:string!, data:object!, dry_run:boolean=False, mode:string|string!, rev_id:string|null=None) +datalens_cloudenvironments_create(cloud_id:string!, description:string|null=None, dry_run:boolean=False, name:string!, security_group_ids:array|null=None, storage:object|null=None, subnet_id:string!) +datalens_cloudenvironments_delete(dry_run:boolean=False, id:string!) datalens_cloudenvironments_get(id:string!, include_permissions:boolean|null=None) datalens_cloudenvironments_list(all:boolean=False, filter:array|null=None, include_permissions:boolean|null=None, limit:integer|null=None, next:string|null=None) -datalens_cloudenvironments_update(description:string|null=None, id:string!, name:string|null=None, security_group_ids:array|null=None, storage:object|null=None) +datalens_cloudenvironments_update(description:string|null=None, dry_run:boolean=False, id:string!, name:string|null=None, security_group_ids:array|null=None, storage:object|null=None) datalens_cloudenvironmentstorage_bucket_download_url_create(cloud_environment_id:string!, path:string!) datalens_cloudenvironmentstorage_bucket_object_metadata_get(cloud_environment_id:string!, path:string!) datalens_cloudenvironmentstorage_bucket_objects_list(all:boolean=False, cloud_environment_id:string!, limit:integer|null=None, next:string|null=None, prefix:string|null=None) -datalens_cloudenvironmentstorage_bucket_upload_url_create(cloud_environment_id:string!, content_md5:string!, path:string!, size:string!) +datalens_cloudenvironmentstorage_bucket_upload_url_create(cloud_environment_id:string!, content_md5:string!, dry_run:boolean=False, path:string!, size:string!) datalens_collections_access_bindings_list(all:boolean=False, collection_id:string!, get_inherited_bindings:boolean|null=None, limit:integer|null=None, next:string|null=None) -datalens_collections_access_bindings_update(collection_id:string!, deltas:array!) +datalens_collections_access_bindings_update(collection_id:string!, deltas:array!, dry_run:boolean=False) datalens_collections_breadcrumbs_list(collection_id:string!, include_permissions_info:boolean|null=None) datalens_collections_content_list(all:boolean=False, collection_id:string|null=None, filter_string:string|null=None, include_permissions_info:boolean|null=None, limit:integer|null=None, mode:string|string|null=None, next:string|null=None, only_my:boolean|null=None, order_direction:string|string|null=None, order_field:string|string|null=None) -datalens_collections_create(description:string|null=None, parent_id:string|null=None, title:string!) -datalens_collections_delete(collection_id:string!) -datalens_collections_delete_bulk(collection_ids:array!) +datalens_collections_create(description:string|null=None, dry_run:boolean=False, parent_id:string|null=None, title:string!) +datalens_collections_delete(collection_id:string!, dry_run:boolean=False) +datalens_collections_delete_bulk(collection_ids:array!, dry_run:boolean=False) datalens_collections_get(collection_id:string!, include_permissions_info:boolean|null=None) datalens_collections_list_by_ids(collection_ids:array!) -datalens_collections_move(collection_id:string!, parent_id:string|null=None, title:string|null=None) -datalens_collections_move_bulk(collection_ids:array!, parent_id:string|null=None) +datalens_collections_move(collection_id:string!, dry_run:boolean=False, parent_id:string|null=None, title:string|null=None) +datalens_collections_move_bulk(collection_ids:array!, dry_run:boolean=False, parent_id:string|null=None) datalens_collections_permissions_get_root() -datalens_collections_update(collection_id:string!, description:string|null=None, title:string|null=None) -datalens_connections_create(connection:object!) -datalens_connections_delete(connection_id:string!) +datalens_collections_update(collection_id:string!, description:string|null=None, dry_run:boolean=False, title:string|null=None) +datalens_connections_create(connection:object!, dry_run:boolean=False) +datalens_connections_delete(connection_id:string!, dry_run:boolean=False) datalens_connections_get(binded_dataset_id:string|null=None, connection_id:string!, rev_id:string|null=None, workbook_id:string|null=None) -datalens_connections_update(connection_id:string!, data:object!) -datalens_dashboards_create(entry:object!) -datalens_dashboards_delete(dashboard_id:string!, lock_token:string|null=None) +datalens_connections_update(connection_id:string!, data:object!, dry_run:boolean=False) +datalens_dashboards_create(dry_run:boolean=False, entry:object!) +datalens_dashboards_delete(dashboard_id:string!, dry_run:boolean=False, lock_token:string|null=None) datalens_dashboards_get(branch:string|string|null=None, dashboard_id:string!, include_favorite:boolean|null=None, include_links:boolean|null=None, include_permissions:boolean|null=None, rev_id:string|null=None, workbook_id:string|null=None) -datalens_dashboards_update(entry:object!, lock_token:string|null=None, mode:string|string!) -datalens_datasets_create(collection_id:string|null=None, created_via:string|null=None, dataset:object!, dir_path:string|null=None, name:string|null=None, options:object|null=None, preview:boolean|null=None, published_id:string|null=None, rev_id:string|null=None, saved_id:string|null=None, workbook_id:string|null=None) +datalens_dashboards_update(dry_run:boolean=False, entry:object!, lock_token:string|null=None, mode:string|string!) +datalens_datasets_create(collection_id:string|null=None, created_via:string|null=None, dataset:object!, dir_path:string|null=None, dry_run:boolean=False, name:string|null=None, options:object|null=None, preview:boolean|null=None, published_id:string|null=None, rev_id:string|null=None, saved_id:string|null=None, workbook_id:string|null=None) datalens_datasets_data_get(columns:array!, dataset_id:string!, filters:array|null=None, limit:integer|null=None, offset:integer|null=None, params:array|null=None, sort:array|null=None, workbook_id:string|null=None) -datalens_datasets_delete(dataset_id:string!) +datalens_datasets_delete(dataset_id:string!, dry_run:boolean=False) datalens_datasets_get(dataset_id:string!, rev_id:string|null=None, workbook_id:string|null=None) -datalens_datasets_update(data:object!, dataset_id:string!, workbook_id:string|null=None) +datalens_datasets_update(data:object!, dataset_id:string!, dry_run:boolean=False, workbook_id:string|null=None) datalens_datasets_validate(binded_dataset_id:string|null=None, data:object!, dataset_id:string!, workbook_id:string|null=None) -datalens_embeddingsecrets_create(title:string!, workbook_id:string!) -datalens_embeddingsecrets_delete(embedding_secret_id:string!) +datalens_embeddingsecrets_create(dry_run:boolean=False, title:string!, workbook_id:string!) +datalens_embeddingsecrets_delete(dry_run:boolean=False, embedding_secret_id:string!) datalens_embeddingsecrets_get(embedding_secret_id:string!) datalens_embeddingsecrets_list(workbook_id:string!) -datalens_embeds_create(deps_ids:array|null=None, embedding_secret_id:string!, entry_id:string!, private_params:array|null=None, public_params_mode:boolean!, settings:object!, title:string!, unsigned_params:array|null=None) -datalens_embeds_delete(embed_id:string!) +datalens_embeds_create(deps_ids:array|null=None, dry_run:boolean=False, embedding_secret_id:string!, entry_id:string!, private_params:array|null=None, public_params_mode:boolean!, settings:object!, title:string!, unsigned_params:array|null=None) +datalens_embeds_delete(dry_run:boolean=False, embed_id:string!) datalens_embeds_list(entry_id:string!) -datalens_embeds_update(deps_ids:array|null=None, embed_id:string!, embedding_secret_id:string!, private_params:array|null=None, public_params_mode:boolean!, settings:object!, title:string!, unsigned_params:array|null=None) +datalens_embeds_update(deps_ids:array|null=None, dry_run:boolean=False, embed_id:string!, embedding_secret_id:string!, private_params:array|null=None, public_params_mode:boolean!, settings:object!, title:string!, unsigned_params:array|null=None) datalens_entries_list(all:boolean=False, created_by:array|null=None, exclude_locked:boolean|null=None, filters:object|null=None, ids:array|null=None, ignore_shared_entries:boolean|null=None, ignore_workbook_entries:boolean|null=None, include_data:boolean|null=None, include_links:boolean|null=None, include_permissions_info:boolean|null=None, limit:integer|null=None, next:string|null=None, order_by:object|null=None, scope:string|string|null=None, scopes:array|null=None, type:array|null=None) datalens_entries_permissions_get(entry_ids:array!) datalens_entries_relations_list(all:boolean=False, entry_ids:array!, include_permissions_info:boolean|null=None, limit:integer|null=None, link_direction:string|null=None, next:string|null=None, scope:string|string|null=None) -datalens_entries_rename(entry_id:string!, name:string!) +datalens_entries_rename(dry_run:boolean=False, entry_id:string!, name:string!) datalens_entries_revisions_list(all:boolean=False, entry_id:string!, limit:integer|null=None, next:string|null=None, rev_ids:array|null=None) -datalens_entrylocks_create(data:object!, entry_id:string!) -datalens_entrylocks_delete(entry_id:string!, params:object!) -datalens_entrylocks_extend(data:object!, entry_id:string!) -datalens_htmlpages_create(annotation:object|null=None, content:string!, key:string|null=None, name:string|null=None, workbook_id:string|null=None) -datalens_htmlpages_delete(entry_id:string!) +datalens_entrylocks_create(data:object!, dry_run:boolean=False, entry_id:string!) +datalens_entrylocks_delete(dry_run:boolean=False, entry_id:string!, params:object!) +datalens_entrylocks_extend(data:object!, dry_run:boolean=False, entry_id:string!) +datalens_htmlpages_create(annotation:object|null=None, content:string!, dry_run:boolean=False, key:string|null=None, name:string|null=None, workbook_id:string|null=None) +datalens_htmlpages_delete(dry_run:boolean=False, entry_id:string!) datalens_htmlpages_get(branch:string|string|null=None, entry_id:string!, include_favorite:boolean|null=None, include_permissions:boolean|null=None, rev_id:string|null=None) datalens_htmlpages_preview_url_get(branch:string|string|null=None, entry_id:string!, lang:string|string|null=None, rev_id:string|null=None, theme:string|string|null=None) -datalens_htmlpages_update(body:object|object!) +datalens_htmlpages_update(body:object|object!, dry_run:boolean=False) datalens_lakehouseoperations_get(operation_id:string!) -datalens_licensing_licenses_assign(user_ids:array!) +datalens_licensing_licenses_assign(dry_run:boolean=False, user_ids:array!) datalens_licensing_licenses_list(all:boolean=False, limit:integer|null=None, next:string|null=None, order:string|string|null=None, sort_by:string|string|null=None, status:string|string|null=None, user_ids:array|null=None) datalens_licensing_limit_get() -datalens_licensing_limit_set(value:integer!) +datalens_licensing_limit_set(dry_run:boolean=False, value:integer!) datalens_members_list(all:boolean=False, filter:string|null=None, language:string|string|null=None, limit:integer|null=None, next:string|null=None, search:string|null=None, tab_id:string|string|null=None) datalens_permissions_get_bulk(collection_ids:array|null=None, entry_ids:array|null=None, workbook_ids:array|null=None) -datalens_reports_create(annotation:object|null=None, data:object!, include_permissions:boolean|null=None, key:string|null=None, meta:?|null!, name:string|null=None, workbook_id:string|null=None) -datalens_reports_delete(entry_id:string!) +datalens_reports_create(annotation:object|null=None, data:object!, dry_run:boolean=False, include_permissions:boolean|null=None, key:string|null=None, meta:?|null!, name:string|null=None, workbook_id:string|null=None) +datalens_reports_delete(dry_run:boolean=False, entry_id:string!) datalens_reports_get(entry_id:string!, include_favorite:boolean|null=None, include_permissions:boolean|null=None, rev_id:string|null=None) -datalens_reports_update(annotation:object|null=None, data:object!, entry_id:string!, meta:?|null!, mode:string|string!, rev_id:string|null=None) -datalens_restcatalogs_create(bucket_settings:object!, cloud_environment_id:string!, description:string|null=None, labels:object|null=None, name:string!) +datalens_reports_update(annotation:object|null=None, data:object!, dry_run:boolean=False, entry_id:string!, meta:?|null!, mode:string|string!, rev_id:string|null=None) +datalens_restcatalogs_create(bucket_settings:object!, cloud_environment_id:string!, description:string|null=None, dry_run:boolean=False, labels:object|null=None, name:string!) datalens_restcatalogs_list(all:boolean=False, cloud_environment_id:string|null=None, filter:array|null=None, include_permissions:boolean|null=None, limit:integer|null=None, next:string|null=None, reverse_order:boolean|null=None, sort_by:string|string|null=None) datalens_sharedentries_access_bindings_list(all:boolean=False, entry_id:string!, get_inherited_bindings:boolean|null=None, limit:integer|null=None, next:string|null=None) -datalens_sharedentries_access_bindings_update(deltas:array!, entry_id:string!) -datalens_sparkapplications_cancel(application_id:string!, cluster_id:string!) -datalens_sparkapplications_create(body:object|object|object!) +datalens_sharedentries_access_bindings_update(deltas:array!, dry_run:boolean=False, entry_id:string!) +datalens_sparkapplications_cancel(application_id:string!, cluster_id:string!, dry_run:boolean=False) +datalens_sparkapplications_create(body:object|object|object!, dry_run:boolean=False) datalens_sparkapplications_get(application_id:string!, cluster_id:string!) datalens_sparkapplications_list(all:boolean=False, cluster_id:string!, filter:array|null=None, limit:integer|null=None, next:string|null=None) datalens_sparkapplications_log_list(application_id:string!, cluster_id:string!, page_size:integer|null=None, page_token:string|null=None) -datalens_sparkclusters_create(cloud_environment_id:string!, collection_id:string!, config:object!, description:string|null=None, labels:object|null=None, name:string!) -datalens_sparkclusters_delete(id:string!) +datalens_sparkclusters_create(cloud_environment_id:string!, collection_id:string!, config:object!, description:string|null=None, dry_run:boolean=False, labels:object|null=None, name:string!) +datalens_sparkclusters_delete(dry_run:boolean=False, id:string!) datalens_sparkclusters_get(id:string!) datalens_sparkclusters_list(all:boolean=False, collection_id:string|null=None, filter:array|null=None, limit:integer|null=None, next:string|null=None) datalens_sparkclusters_resource_presets_get(cloud_environment_id:string!, resource_preset_id:string!) datalens_sparkclusters_resource_presets_list(all:boolean=False, cloud_environment_id:string!, limit:integer|null=None, next:string|null=None) -datalens_sparkclusters_start(cluster_id:string!) -datalens_sparkclusters_stop(cluster_id:string!) -datalens_sqlqueries_create(connection_id:string!, description:string|null=None, name:string!, params:array|null=None, query:string!, workbook_id:string!) -datalens_sqlqueries_delete(sql_query_id:string!) +datalens_sparkclusters_start(cluster_id:string!, dry_run:boolean=False) +datalens_sparkclusters_stop(cluster_id:string!, dry_run:boolean=False) +datalens_sqlqueries_create(connection_id:string!, description:string|null=None, dry_run:boolean=False, name:string!, params:array|null=None, query:string!, workbook_id:string!) +datalens_sqlqueries_delete(dry_run:boolean=False, sql_query_id:string!) datalens_sqlqueries_get(include_favorite:boolean|null=None, include_permissions:boolean|null=None, rev_id:string|null=None, sql_query_id:string!) -datalens_sqlqueries_run(params:object|null=None, sql_query_id:string!) -datalens_sqlqueries_update(connection_id:string!, description:string|null=None, params:array|null=None, query:string!, sql_query_id:string!) +datalens_sqlqueries_run(dry_run:boolean=False, params:object|null=None, sql_query_id:string!) +datalens_sqlqueries_update(connection_id:string!, description:string|null=None, dry_run:boolean=False, params:array|null=None, query:string!, sql_query_id:string!) datalens_tenant_details_get() -datalens_trinoclusters_catalog_create(catalog:object!, cluster_id:string!) -datalens_trinoclusters_catalog_delete(catalog_id:string!, cluster_id:string!) -datalens_trinoclusters_create(catalogs_config:array|null=None, cloud_environment_id:string!, collection_id:string!, description:string|null=None, labels:object|null=None, name:string!, trino_version:string|null=None, worker_config:object!) -datalens_trinoclusters_delete(id:string!) +datalens_trinoclusters_catalog_create(catalog:object!, cluster_id:string!, dry_run:boolean=False) +datalens_trinoclusters_catalog_delete(catalog_id:string!, cluster_id:string!, dry_run:boolean=False) +datalens_trinoclusters_create(catalogs_config:array|null=None, cloud_environment_id:string!, collection_id:string!, description:string|null=None, dry_run:boolean=False, labels:object|null=None, name:string!, trino_version:string|null=None, worker_config:object!) +datalens_trinoclusters_delete(dry_run:boolean=False, id:string!) datalens_trinoclusters_get(id:string!) datalens_trinoclusters_list(all:boolean=False, catalog_id:string|null=None, collection_id:string|null=None, filter:array|null=None, limit:integer|null=None, next:string|null=None) datalens_trinoclusters_resource_preset_get(cloud_environment_id:string!, resource_preset_id:string!) datalens_trinoclusters_resource_presets_list(all:boolean=False, cloud_environment_id:string!, limit:integer|null=None, next:string|null=None) -datalens_trinoclusters_start(cluster_id:string!) -datalens_trinoclusters_stop(cluster_id:string!) -datalens_workbookexports_cancel(export_id:string!) +datalens_trinoclusters_start(cluster_id:string!, dry_run:boolean=False) +datalens_trinoclusters_stop(cluster_id:string!, dry_run:boolean=False) +datalens_workbookexports_cancel(dry_run:boolean=False, export_id:string!) datalens_workbookexports_result_get(export_id:string!) -datalens_workbookexports_start(workbook_id:string!) +datalens_workbookexports_start(dry_run:boolean=False, workbook_id:string!) datalens_workbookexports_status_get(export_id:string!) -datalens_workbookimports_start(collection_id:string|null=None, data:object!, description:string|null=None, title:string!) +datalens_workbookimports_start(collection_id:string|null=None, data:object!, description:string|null=None, dry_run:boolean=False, title:string!) datalens_workbookimports_status_get(import_id:string!) datalens_workbooks_access_bindings_list(all:boolean=False, get_inherited_bindings:boolean|null=None, limit:integer|null=None, next:string|null=None, workbook_id:string!) -datalens_workbooks_access_bindings_update(deltas:array!, workbook_id:string!) -datalens_workbooks_create(collection_id:string|null=None, description:string|null=None, title:string!) -datalens_workbooks_delete(workbook_id:string!) -datalens_workbooks_delete_bulk(workbook_ids:array!) +datalens_workbooks_access_bindings_update(deltas:array!, dry_run:boolean=False, workbook_id:string!) +datalens_workbooks_create(collection_id:string|null=None, description:string|null=None, dry_run:boolean=False, title:string!) +datalens_workbooks_delete(dry_run:boolean=False, workbook_id:string!) +datalens_workbooks_delete_bulk(dry_run:boolean=False, workbook_ids:array!) datalens_workbooks_entries_list(all:boolean=False, created_by:string|null=None, filters:object|null=None, include_permissions_info:boolean|null=None, limit:integer|null=None, next:string|null=None, only_my:boolean|null=None, order_by:object|null=None, scope:array|null=None, workbook_id:string!) datalens_workbooks_get(include_permissions_info:boolean|null=None, workbook_id:string!) datalens_workbooks_list(all:boolean=False, collection_id:string|null=None, filter_string:string|null=None, include_permissions_info:boolean|null=None, limit:integer|null=None, next:string|null=None, only_my:boolean|null=None, order_direction:string|string|null=None, order_field:string|string|null=None) datalens_workbooks_list_by_ids(workbook_ids:array!) -datalens_workbooks_move(collection_id:string|null=None, title:string|null=None, workbook_id:string!) -datalens_workbooks_move_bulk(collection_id:string|null=None, workbook_ids:array!) -datalens_workbooks_update(description:string|null=None, title:string|null=None, workbook_id:string!) -forms_access_grant(body:object!, survey_id:string!) +datalens_workbooks_move(collection_id:string|null=None, dry_run:boolean=False, title:string|null=None, workbook_id:string!) +datalens_workbooks_move_bulk(collection_id:string|null=None, dry_run:boolean=False, workbook_ids:array!) +datalens_workbooks_update(description:string|null=None, dry_run:boolean=False, title:string|null=None, workbook_id:string!) +forms_access_grant(body:object!, dry_run:boolean=False, survey_id:string!) forms_access_list(survey_id:string!) -forms_access_revoke(body:object!, survey_id:string!) -forms_access_update(body:object!, survey_id:string!) +forms_access_revoke(body:object!, dry_run:boolean=False, survey_id:string!) +forms_access_update(body:object!, dry_run:boolean=False, survey_id:string!) forms_answers_columns_list(questions:string|null=None, survey_id:string!, use_slugs:boolean|null=None) -forms_answers_delete(answer_id:integer!, survey_id:string!) -forms_answers_export(body:object!, survey_id:string!) +forms_answers_delete(answer_id:integer!, dry_run:boolean=False, survey_id:string!) +forms_answers_export(body:object!, dry_run:boolean=False, survey_id:string!) forms_answers_get(answer_id:integer|null=None, answer_key:string|null=None) forms_answers_integrations_list(answer_id:integer|null=None, answer_key:string|null=None) forms_answers_list(all:boolean=False, answer_format:string|string|null=None, date_from:string|null=None, date_to:string|null=None, limit:integer|null=None, next:string|null=None, ordering:string|string|null=None, page_size:integer|null=None, questions:string|null=None, survey_id:string!, use_slugs:boolean|null=None) -forms_answers_restore(answer_id:integer!, survey_id:string!) -forms_conditions_hook_create(body:object!, hook_id:integer!, survey_id:string!) -forms_conditions_hook_delete(condition_id:integer!, hook_id:integer!, survey_id:string!) +forms_answers_restore(answer_id:integer!, dry_run:boolean=False, survey_id:string!) +forms_conditions_hook_create(body:object!, dry_run:boolean=False, hook_id:integer!, survey_id:string!) +forms_conditions_hook_delete(condition_id:integer!, dry_run:boolean=False, hook_id:integer!, survey_id:string!) forms_conditions_hook_get(condition_id:integer!, hook_id:integer!, survey_id:string!) forms_conditions_hook_list(hook_id:integer!, survey_id:string!) -forms_conditions_hook_update(body:object!, condition_id:integer!, hook_id:integer!, survey_id:string!) -forms_conditions_hook_update_operator(hook_id:integer!, operator:string|string!, survey_id:string!) -forms_conditions_page_create(body:object!, page_id:integer!, survey_id:string!) -forms_conditions_page_delete(condition_id:integer!, page_id:integer!, survey_id:string!) +forms_conditions_hook_update(body:object!, condition_id:integer!, dry_run:boolean=False, hook_id:integer!, survey_id:string!) +forms_conditions_hook_update_operator(dry_run:boolean=False, hook_id:integer!, operator:string|string!, survey_id:string!) +forms_conditions_page_create(body:object!, dry_run:boolean=False, page_id:integer!, survey_id:string!) +forms_conditions_page_delete(condition_id:integer!, dry_run:boolean=False, page_id:integer!, survey_id:string!) forms_conditions_page_get(condition_id:integer!, page_id:integer!, survey_id:string!) forms_conditions_page_list(page_id:integer!, survey_id:string!) -forms_conditions_page_update(body:object!, condition_id:integer!, page_id:integer!, survey_id:string!) -forms_conditions_page_update_operator(operator:string|string!, page_id:integer!, survey_id:string!) -forms_conditions_question_create(body:object!, question_id:string!, survey_id:string!) -forms_conditions_question_delete(condition_id:integer!, question_id:string!, survey_id:string!) +forms_conditions_page_update(body:object!, condition_id:integer!, dry_run:boolean=False, page_id:integer!, survey_id:string!) +forms_conditions_page_update_operator(dry_run:boolean=False, operator:string|string!, page_id:integer!, survey_id:string!) +forms_conditions_question_create(body:object!, dry_run:boolean=False, question_id:string!, survey_id:string!) +forms_conditions_question_delete(condition_id:integer!, dry_run:boolean=False, question_id:string!, survey_id:string!) forms_conditions_question_get(condition_id:integer!, question_id:string!, survey_id:string!) forms_conditions_question_list(question_id:string!, survey_id:string!) -forms_conditions_question_update(body:object!, condition_id:integer!, question_id:string!, survey_id:string!) -forms_conditions_question_update_operator(operator:string|string!, question_id:string!, survey_id:string!) -forms_conditions_submit_create(body:object!, survey_id:string!) -forms_conditions_submit_delete(condition_id:integer!, survey_id:string!) +forms_conditions_question_update(body:object!, condition_id:integer!, dry_run:boolean=False, question_id:string!, survey_id:string!) +forms_conditions_question_update_operator(dry_run:boolean=False, operator:string|string!, question_id:string!, survey_id:string!) +forms_conditions_submit_create(body:object!, dry_run:boolean=False, survey_id:string!) +forms_conditions_submit_delete(condition_id:integer!, dry_run:boolean=False, survey_id:string!) forms_conditions_submit_get(condition_id:integer!, survey_id:string!) forms_conditions_submit_list(survey_id:string!) -forms_conditions_submit_update(body:object!, condition_id:integer!, survey_id:string!) -forms_conditions_submit_update_operator(operator:string|string!, survey_id:string!) -forms_files_delete(path:string|null=None, url:string|null=None) +forms_conditions_submit_update(body:object!, condition_id:integer!, dry_run:boolean=False, survey_id:string!) +forms_conditions_submit_update_operator(dry_run:boolean=False, operator:string|string!, survey_id:string!) +forms_files_delete(dry_run:boolean=False, path:string|null=None, url:string|null=None) forms_files_verify(files:array!, survey_id:string!) forms_filling_get(key:string|null=None, survey_id:string!) -forms_filling_submit(body:object!, key:string|null=None, survey_id:string!, validate_only:boolean|null=None) +forms_filling_submit(body:object!, dry_run:boolean=False, key:string|null=None, survey_id:string!, validate_only:boolean|null=None) forms_filling_suggest(parent_id:string|null=None, question:string|null=None, suggest_id:string|null=None, survey_id:string!, text:string|null=None) forms_history_list(all:boolean=False, limit:integer|null=None, next:string|null=None, ordering:string|string|null=None, survey_id:string!) -forms_hooks_create(body:object!, survey_id:string!) -forms_hooks_delete(hook_id:integer!, survey_id:string!) +forms_hooks_create(body:object!, dry_run:boolean=False, survey_id:string!) +forms_hooks_delete(dry_run:boolean=False, hook_id:integer!, survey_id:string!) forms_hooks_get(hook_id:integer!, survey_id:string!) forms_hooks_list(survey_id:string!) -forms_hooks_update(body:object!, hook_id:integer!, survey_id:string!) -forms_images_clone(body:object!, survey_id:string!) -forms_keysets_create(body:object!, survey_id:string!) -forms_keysets_delete(keyset_id:integer!, survey_id:string!) +forms_hooks_update(body:object!, dry_run:boolean=False, hook_id:integer!, survey_id:string!) +forms_images_clone(body:object!, dry_run:boolean=False, survey_id:string!) +forms_keysets_create(body:object!, dry_run:boolean=False, survey_id:string!) +forms_keysets_delete(dry_run:boolean=False, keyset_id:integer!, survey_id:string!) forms_keysets_get(keyset_id:integer!, survey_id:string!) forms_keysets_list(survey_id:string!) -forms_keysets_update(body:object!, keyset_id:integer!, survey_id:string!) +forms_keysets_update(body:object!, dry_run:boolean=False, keyset_id:integer!, survey_id:string!) forms_me_get() -forms_notifications_cancel(notification_id:integer!) +forms_notifications_cancel(dry_run:boolean=False, notification_id:integer!) forms_notifications_errors_list(survey_id:string!) forms_notifications_get(notification_id:integer!) forms_notifications_list(all:boolean=False, answer_id:integer|null=None, created_since:string|null=None, created_until:string|null=None, finished_since:string|null=None, finished_until:string|null=None, hook_id:integer|null=None, integration_type:string|string|null=None, limit:integer|null=None, next:string|null=None, ordering:string|string|null=None, status:array|null=None, subscription_id:integer|null=None, survey_id:string|null=None, visible:boolean|null=None) -forms_notifications_restart(notification_id:integer!) +forms_notifications_restart(dry_run:boolean=False, notification_id:integer!) forms_notifications_status_get(notification_id:integer!) forms_operations_get(operation_id:string!) -forms_questions_create(body:StringQuestion|BooleanQuestion|IntegerQuestion|FileQuestion|CommentQuestion|DateQuestion|DateRangeQuestion|PaymentQuestion|EnumQuestion|SuggestQuestion|MatrixQuestion|SeriesQuestion!, survey_id:string!) -forms_questions_delete(force:boolean|null=None, question_id:string!, survey_id:string!) +forms_questions_create(body:StringQuestion|BooleanQuestion|IntegerQuestion|FileQuestion|CommentQuestion|DateQuestion|DateRangeQuestion|PaymentQuestion|EnumQuestion|SuggestQuestion|MatrixQuestion|SeriesQuestion!, dry_run:boolean=False, survey_id:string!) +forms_questions_delete(dry_run:boolean=False, force:boolean|null=None, question_id:string!, survey_id:string!) forms_questions_get(question_id:string!, survey_id:string!, with_slugs:boolean|null=None) forms_questions_list(survey_id:string!) -forms_questions_move(body:object!, question_id:string!, survey_id:string!) -forms_questions_update(body:StringQuestion|BooleanQuestion|IntegerQuestion|FileQuestion|CommentQuestion|DateQuestion|DateRangeQuestion|PaymentQuestion|EnumQuestion|SuggestQuestion|MatrixQuestion|SeriesQuestion!, question_id:string!, survey_id:string!) -forms_subscriptions_create(body:object!, hook_id:integer!, survey_id:string!) -forms_subscriptions_delete(hook_id:integer!, subscription_id:integer!, survey_id:string!) +forms_questions_move(body:object!, dry_run:boolean=False, question_id:string!, survey_id:string!) +forms_questions_update(body:StringQuestion|BooleanQuestion|IntegerQuestion|FileQuestion|CommentQuestion|DateQuestion|DateRangeQuestion|PaymentQuestion|EnumQuestion|SuggestQuestion|MatrixQuestion|SeriesQuestion!, dry_run:boolean=False, question_id:string!, survey_id:string!) +forms_subscriptions_create(body:object!, dry_run:boolean=False, hook_id:integer!, survey_id:string!) +forms_subscriptions_delete(dry_run:boolean=False, hook_id:integer!, subscription_id:integer!, survey_id:string!) forms_subscriptions_get(hook_id:integer!, subscription_id:integer!, survey_id:string!) forms_subscriptions_list(hook_id:integer!, survey_id:string!) -forms_subscriptions_update(body:object!, hook_id:integer!, subscription_id:integer!, survey_id:string!) -forms_surveys_create(body:object!) -forms_surveys_delete(survey_id:string!) +forms_subscriptions_update(body:object!, dry_run:boolean=False, hook_id:integer!, subscription_id:integer!, survey_id:string!) +forms_surveys_create(body:object!, dry_run:boolean=False) +forms_surveys_delete(dry_run:boolean=False, survey_id:string!) forms_surveys_get(survey_id:string!) forms_surveys_list(all:boolean=False, favourite:boolean|null=None, group:string|null=None, limit:integer|null=None, name:string|null=None, next:string|null=None, orderby:string|null=None, ownership:string|null=None, published:boolean|null=None, show_all:boolean|null=None) -forms_surveys_publish(survey_id:string!) -forms_surveys_unpublish(survey_id:string!) -forms_surveys_update(body:object!, survey_id:string!) +forms_surveys_publish(dry_run:boolean=False, survey_id:string!) +forms_surveys_unpublish(dry_run:boolean=False, survey_id:string!) +forms_surveys_update(body:object!, dry_run:boolean=False, survey_id:string!) forms_variables_list(survey_id:string!) schema_get(name:string|null=None, service:string|null=None, tool:string|null=None) status_get() tracker_applications_list() -tracker_attachments_delete(file_id:string!, issue_key:string!) +tracker_attachments_delete(dry_run:boolean=False, file_id:string!, issue_key:string!) tracker_attachments_get(file_id:string!, issue_key:string!) -tracker_attachments_import(created_at:string!, created_by:string!, data:string!, filename:string!, issue_key:string!) +tracker_attachments_import(created_at:string!, created_by:string!, data:string!, dry_run:boolean=False, filename:string!, issue_key:string!) tracker_attachments_list(issue_key:string!) -tracker_attachments_upload(data:string!, filename:string!, issue_key:string!, rename_to:string|null=None) -tracker_attachments_upload_temp(data:string!, filename:string!, rename_to:string|null=None) -tracker_autoactions_create(body:object!, queue_id:string!) +tracker_attachments_upload(data:string!, dry_run:boolean=False, filename:string!, issue_key:string!, rename_to:string|null=None) +tracker_attachments_upload_temp(data:string!, dry_run:boolean=False, filename:string!, rename_to:string|null=None) +tracker_autoactions_create(body:object!, dry_run:boolean=False, queue_id:string!) tracker_autoactions_get(action_id:integer!, queue_id:string!) tracker_autoactions_logs_get(action_id:integer!, queue_id:string!, run_id:string!) tracker_autoactions_logs_list(action_id:integer!, queue_id:string!) -tracker_boards_create(body:object!) -tracker_boards_delete(board_id:integer!) +tracker_boards_create(body:object!, dry_run:boolean=False) +tracker_boards_delete(board_id:integer!, dry_run:boolean=False) tracker_boards_get(board_id:integer!) tracker_boards_list(all:boolean=False, limit:integer|null=None, next:string|null=None) -tracker_boards_update(board_id:integer!, body:object!) +tracker_boards_update(board_id:integer!, body:object!, dry_run:boolean=False) tracker_bulk_get(bulk_id:string!) tracker_bulk_issues_list(bulk_id:string!) tracker_changelog_list(all:boolean=False, change_type:string|null=None, field:string|null=None, issue_key:string!, limit:integer|null=None, next:string|null=None, sort:string|string|null=None) -tracker_checklists_clear(issue_key:string!) -tracker_checklists_create(body:object!, issue_key:string!) -tracker_checklists_delete(issue_key:string!, item_id:string!) +tracker_checklists_clear(dry_run:boolean=False, issue_key:string!) +tracker_checklists_create(body:object!, dry_run:boolean=False, issue_key:string!) +tracker_checklists_delete(dry_run:boolean=False, issue_key:string!, item_id:string!) tracker_checklists_list(issue_key:string!) -tracker_checklists_update(body:object!, issue_key:string!, item_id:string!) -tracker_columns_create(board_id:integer!, body:object!) -tracker_columns_delete(board_id:integer!, column_id:integer!) +tracker_checklists_update(body:object!, dry_run:boolean=False, issue_key:string!, item_id:string!) +tracker_columns_create(board_id:integer!, body:object!, dry_run:boolean=False) +tracker_columns_delete(board_id:integer!, column_id:integer!, dry_run:boolean=False) tracker_columns_get(board_id:integer!, column_id:integer!) tracker_columns_list(board_id:integer!) -tracker_columns_update(board_id:integer!, body:object!, column_id:integer!) -tracker_comments_create(body:object!, issue_key:string!) -tracker_comments_delete(comment_id:integer|string!, issue_key:string!) +tracker_columns_update(board_id:integer!, body:object!, column_id:integer!, dry_run:boolean=False) +tracker_comments_create(body:object!, dry_run:boolean=False, issue_key:string!) +tracker_comments_delete(comment_id:integer|string!, dry_run:boolean=False, issue_key:string!) tracker_comments_get(comment_id:integer|string!, expand:string|null=None, issue_key:string!) -tracker_comments_import(body:object!, issue_key:string!) +tracker_comments_import(body:object!, dry_run:boolean=False, issue_key:string!) tracker_comments_list(all:boolean=False, expand:string|null=None, issue_key:string!, limit:integer|null=None, next:string|null=None) -tracker_comments_reactions_create(comment_id:integer|string!, issue_key:string!, name:string!) -tracker_comments_update(body:object!, comment_id:integer|string!, issue_key:string!) -tracker_components_create(body:object!) -tracker_components_delete(component_id:integer!) +tracker_comments_reactions_create(comment_id:integer|string!, dry_run:boolean=False, issue_key:string!, name:string!) +tracker_comments_update(body:object!, comment_id:integer|string!, dry_run:boolean=False, issue_key:string!) +tracker_components_create(body:object!, dry_run:boolean=False) +tracker_components_delete(component_id:integer!, dry_run:boolean=False) tracker_components_get(component_id:integer!, fields:string|null=None) tracker_components_group_permissions_get(component_id:integer!, group_id:integer!) tracker_components_list() tracker_components_list_for_queue(fields:string|null=None, queue_id:string!) -tracker_components_update(body:object!, component_id:integer!, version:integer|null=None) +tracker_components_update(body:object!, component_id:integer!, dry_run:boolean=False, version:integer|null=None) tracker_components_user_permissions_get(component_id:integer!, user_id:string!) -tracker_dashboards_create(body:object!) -tracker_dashboards_widgets_create_cycle_time(body:object!, dashboard_id:string!) -tracker_entities_attachments_attach(entity_id:string!, entity_type:string!, expand:string|null=None, fields:string|null=None, notify:boolean|null=None, notify_author:boolean|null=None, temp_file_id:string!) -tracker_entities_attachments_delete(entity_id:string!, entity_type:string!, file_id:string!) +tracker_dashboards_create(body:object!, dry_run:boolean=False) +tracker_dashboards_widgets_create_cycle_time(body:object!, dashboard_id:string!, dry_run:boolean=False) +tracker_entities_attachments_attach(dry_run:boolean=False, entity_id:string!, entity_type:string!, expand:string|null=None, fields:string|null=None, notify:boolean|null=None, notify_author:boolean|null=None, temp_file_id:string!) +tracker_entities_attachments_delete(dry_run:boolean=False, entity_id:string!, entity_type:string!, file_id:string!) tracker_entities_attachments_get(entity_id:string!, entity_type:string!, file_id:string!) tracker_entities_attachments_list(entity_id:string!, entity_type:string!) tracker_entities_bulk_get(bulk_id:string!) -tracker_entities_checklists_create(body:array!, entity_id:string!, entity_type:string!, expand:string|null=None, fields:string|null=None, notify:boolean|null=None, notify_author:boolean|null=None) -tracker_entities_checklists_delete(entity_id:string!, entity_type:string!, expand:string|null=None, fields:string|null=None, notify:boolean|null=None, notify_author:boolean|null=None) -tracker_entities_checklists_items_delete(entity_id:string!, entity_type:string!, expand:string|null=None, fields:string|null=None, item_id:string!, notify:boolean|null=None, notify_author:boolean|null=None) -tracker_entities_checklists_items_update(body:object!, entity_id:string!, entity_type:string!, expand:string|null=None, fields:string|null=None, item_id:string!, notify:boolean|null=None, notify_author:boolean|null=None) -tracker_entities_checklists_move(body:object!, entity_id:string!, entity_type:string!, expand:string|null=None, fields:string|null=None, item_id:string!, notify:boolean|null=None, notify_author:boolean|null=None) -tracker_entities_checklists_update(body:array!, entity_id:string!, entity_type:string!, expand:string|null=None, fields:string|null=None, notify:boolean|null=None, notify_author:boolean|null=None) -tracker_entities_comments_create(body:object!, entity_id:string!, entity_type:string!, expand:string|null=None, is_add_to_followers:boolean|null=None, notify:boolean|null=None, notify_author:boolean|null=None) -tracker_entities_comments_delete(comment_id:string!, entity_id:string!, entity_type:string!, notify:boolean|null=None, notify_author:boolean|null=None) +tracker_entities_checklists_create(body:array!, dry_run:boolean=False, entity_id:string!, entity_type:string!, expand:string|null=None, fields:string|null=None, notify:boolean|null=None, notify_author:boolean|null=None) +tracker_entities_checklists_delete(dry_run:boolean=False, entity_id:string!, entity_type:string!, expand:string|null=None, fields:string|null=None, notify:boolean|null=None, notify_author:boolean|null=None) +tracker_entities_checklists_items_delete(dry_run:boolean=False, entity_id:string!, entity_type:string!, expand:string|null=None, fields:string|null=None, item_id:string!, notify:boolean|null=None, notify_author:boolean|null=None) +tracker_entities_checklists_items_update(body:object!, dry_run:boolean=False, entity_id:string!, entity_type:string!, expand:string|null=None, fields:string|null=None, item_id:string!, notify:boolean|null=None, notify_author:boolean|null=None) +tracker_entities_checklists_move(body:object!, dry_run:boolean=False, entity_id:string!, entity_type:string!, expand:string|null=None, fields:string|null=None, item_id:string!, notify:boolean|null=None, notify_author:boolean|null=None) +tracker_entities_checklists_update(body:array!, dry_run:boolean=False, entity_id:string!, entity_type:string!, expand:string|null=None, fields:string|null=None, notify:boolean|null=None, notify_author:boolean|null=None) +tracker_entities_comments_create(body:object!, dry_run:boolean=False, entity_id:string!, entity_type:string!, expand:string|null=None, is_add_to_followers:boolean|null=None, notify:boolean|null=None, notify_author:boolean|null=None) +tracker_entities_comments_delete(comment_id:string!, dry_run:boolean=False, entity_id:string!, entity_type:string!, notify:boolean|null=None, notify_author:boolean|null=None) tracker_entities_comments_get(comment_id:string!, entity_id:string!, entity_type:string!, expand:string|null=None) tracker_entities_comments_list(entity_id:string!, entity_type:string!, expand:string|null=None) tracker_entities_comments_list_relative(all:boolean=False, entity_id:string!, entity_type:string!, limit:integer|null=None, next:string|null=None) -tracker_entities_comments_update(body:object!, comment_id:string!, entity_id:string!, entity_type:string!, expand:string|null=None, is_add_to_followers:boolean|null=None, notify:boolean|null=None, notify_author:boolean|null=None) -tracker_entities_create(body:object!, entity_type:string!, fields:string|null=None) -tracker_entities_delete(entity_id:string!, entity_type:string!, with_board:boolean|null=None) +tracker_entities_comments_update(body:object!, comment_id:string!, dry_run:boolean=False, entity_id:string!, entity_type:string!, expand:string|null=None, is_add_to_followers:boolean|null=None, notify:boolean|null=None, notify_author:boolean|null=None) +tracker_entities_create(body:object!, dry_run:boolean=False, entity_type:string!, fields:string|null=None) +tracker_entities_delete(dry_run:boolean=False, entity_id:string!, entity_type:string!, with_board:boolean|null=None) tracker_entities_events_list(all:boolean=False, direction:string|null=None, entity_id:string!, entity_type:string!, limit:integer|null=None, new_events_on_top:boolean|null=None, next:string|null=None, selected:string|null=None) tracker_entities_get(entity_id:string!, entity_type:string!, expand:string|null=None, fields:string|null=None) -tracker_entities_links_create(body:object!, entity_id:string!, entity_type:string!) -tracker_entities_links_delete(entity_id:string!, entity_type:string!, right:string!) +tracker_entities_links_create(body:object!, dry_run:boolean=False, entity_id:string!, entity_type:string!) +tracker_entities_links_delete(dry_run:boolean=False, entity_id:string!, entity_type:string!, right:string!) tracker_entities_links_list(entity_id:string!, entity_type:string!, fields:string|null=None) tracker_entities_permissions_get(entity_id:string!, entity_type:string!) tracker_entities_permissions_get_direct(entity_id:string!, entity_type:string!) -tracker_entities_permissions_update(body:object!, entity_id:string!, entity_type:string!) -tracker_entities_permissions_update_direct(body:object!, entity_id:string!, entity_type:string!) -tracker_entities_reports_create(body:object!) +tracker_entities_permissions_update(body:object!, dry_run:boolean=False, entity_id:string!, entity_type:string!) +tracker_entities_permissions_update_direct(body:object!, dry_run:boolean=False, entity_id:string!, entity_type:string!) +tracker_entities_reports_create(body:object!, dry_run:boolean=False) tracker_entities_search(all:boolean=False, body:object|null=None, entity_type:string!, fields:string|null=None, limit:integer|null=None, next:string|null=None) -tracker_entities_update(body:object!, entity_id:string!, entity_type:string!, expand:string|null=None, fields:string|null=None) -tracker_entities_update_bulk(body:object!, entity_type:string!) -tracker_fields_categories_create(body:object!) -tracker_fields_categories_update(body:object!, category_id:string!, version:integer|null=None) -tracker_fields_create(body:object!) +tracker_entities_update(body:object!, dry_run:boolean=False, entity_id:string!, entity_type:string!, expand:string|null=None, fields:string|null=None) +tracker_entities_update_bulk(body:object!, dry_run:boolean=False, entity_type:string!) +tracker_fields_categories_create(body:object!, dry_run:boolean=False) +tracker_fields_categories_update(body:object!, category_id:string!, dry_run:boolean=False, version:integer|null=None) +tracker_fields_create(body:object!, dry_run:boolean=False) tracker_fields_get(field_id:string!) tracker_fields_list() -tracker_fields_update(body:object!, field_id:string!, version:integer|null=None) -tracker_filters_create(body:object!) -tracker_filters_delete(filter_id:string!) +tracker_fields_update(body:object!, dry_run:boolean=False, field_id:string!, version:integer|null=None) +tracker_filters_create(body:object!, dry_run:boolean=False) +tracker_filters_delete(dry_run:boolean=False, filter_id:string!) tracker_filters_get(filter_id:string!) -tracker_filters_update(body:object!, filter_id:string!) -tracker_gaps_create(body:object!) -tracker_gaps_delete(gap_ids:array!) +tracker_filters_update(body:object!, dry_run:boolean=False, filter_id:string!) +tracker_gaps_create(body:object!, dry_run:boolean=False) +tracker_gaps_delete(dry_run:boolean=False, gap_ids:array!) tracker_gaps_search(all:boolean=False, date_from:string|null=None, date_to:string|null=None, limit:integer|null=None, next:string|null=None, users:array!) tracker_issues_count(body:object!) -tracker_issues_create(body:object!, notify:boolean|null=None) +tracker_issues_create(body:object!, dry_run:boolean=False, notify:boolean|null=None) tracker_issues_get(expand:string|null=None, fields:string|null=None, issue_key:string!) -tracker_issues_import(body:object!) +tracker_issues_import(body:object!, dry_run:boolean=False) tracker_issues_list(all:boolean=False, assignee:string|null=None, epic:string|null=None, issue_type:string|null=None, limit:integer|null=None, next:string|null=None, queue:string|null=None, status:string|null=None) -tracker_issues_move(expand:string|null=None, initial_status:boolean|null=None, issue_key:string!, move_all_fields:boolean|null=None, notify:boolean|null=None, notify_author:boolean|null=None, queue:string!) -tracker_issues_move_bulk(body:object!, notify:boolean|null=None) -tracker_issues_scroll_clear(next:string!) +tracker_issues_move(dry_run:boolean=False, expand:string|null=None, initial_status:boolean|null=None, issue_key:string!, move_all_fields:boolean|null=None, notify:boolean|null=None, notify_author:boolean|null=None, queue:string!) +tracker_issues_move_bulk(body:object!, dry_run:boolean=False, notify:boolean|null=None) +tracker_issues_scroll_clear(dry_run:boolean=False, next:string!) tracker_issues_search(all:boolean=False, body:object!, expand:string|null=None, limit:integer|null=None, next:string|null=None, per_scroll:integer|null=None, scroll_ttl_millis:integer|null=None, scroll_type:string|string|null=None) tracker_issues_suggest(embed:string|null=None, expand:string|null=None, fields:string|null=None, full:boolean|null=None, queue:string|null=None, text:string!) -tracker_issues_transition_bulk(body:object!, notify:boolean|null=None) -tracker_issues_update(body:object!, issue_key:string!) -tracker_issues_update_bulk(body:object!, notify:boolean|null=None) -tracker_issuetypes_create(body:object!) +tracker_issues_transition_bulk(body:object!, dry_run:boolean=False, notify:boolean|null=None) +tracker_issues_update(body:object!, dry_run:boolean=False, issue_key:string!) +tracker_issues_update_bulk(body:object!, dry_run:boolean=False, notify:boolean|null=None) +tracker_issuetypes_create(body:object!, dry_run:boolean=False) tracker_issuetypes_list() -tracker_issuetypes_update(body:object!, issue_type_id:string!, version:integer|null=None) -tracker_links_create(body:object!, issue_key:string!) -tracker_links_delete(issue_key:string!, link_id:string!) -tracker_links_import(body:object!, issue_key:string!) +tracker_issuetypes_update(body:object!, dry_run:boolean=False, issue_type_id:string!, version:integer|null=None) +tracker_links_create(body:object!, dry_run:boolean=False, issue_key:string!) +tracker_links_delete(dry_run:boolean=False, issue_key:string!, link_id:string!) +tracker_links_import(body:object!, dry_run:boolean=False, issue_key:string!) tracker_links_list(issue_key:string!) tracker_links_list_filtered(all:boolean=False, fields:array|null=None, issue_key:string!, limit:integer|null=None, link_types:array|null=None, next:string|null=None) tracker_linktypes_list() -tracker_localfields_create(body:object!, queue_id:string!) +tracker_localfields_create(body:object!, dry_run:boolean=False, queue_id:string!) tracker_localfields_get(field_key:string!, queue_id:string!) tracker_localfields_list(queue_id:string!) -tracker_localfields_update(body:object!, field_key:string!, queue_id:string!) -tracker_macros_create(body:object!, queue_id:string!) -tracker_macros_delete(macro_id:integer!, queue_id:string!) +tracker_localfields_update(body:object!, dry_run:boolean=False, field_key:string!, queue_id:string!) +tracker_macros_create(body:object!, dry_run:boolean=False, queue_id:string!) +tracker_macros_delete(dry_run:boolean=False, macro_id:integer!, queue_id:string!) tracker_macros_get(macro_id:integer!, queue_id:string!) tracker_macros_list(queue_id:string!) -tracker_macros_update(body:object!, macro_id:integer!, queue_id:string!) +tracker_macros_update(body:object!, dry_run:boolean=False, macro_id:integer!, queue_id:string!) tracker_me_get() -tracker_priorities_create(body:object!) +tracker_priorities_create(body:object!, dry_run:boolean=False) tracker_priorities_list(localized:boolean|null=None) -tracker_priorities_update(body:object!, priority_id:string!, version:integer|null=None) -tracker_projects_create(body:object!) -tracker_projects_delete(project_id:integer!) +tracker_priorities_update(body:object!, dry_run:boolean=False, priority_id:string!, version:integer|null=None) +tracker_projects_create(body:object!, dry_run:boolean=False) +tracker_projects_delete(dry_run:boolean=False, project_id:integer!) tracker_projects_get(expand:string|null=None, project_id:integer!) tracker_projects_list(expand:string|null=None) tracker_projects_queues_list(expand:string|null=None, project_id:integer!) -tracker_projects_update(body:object!, expand:string|null=None, project_id:integer!, version:integer!) -tracker_queues_create(body:object!) -tracker_queues_delete(queue_id:string!) +tracker_projects_update(body:object!, dry_run:boolean=False, expand:string|null=None, project_id:integer!, version:integer!) +tracker_queues_create(body:object!, dry_run:boolean=False) +tracker_queues_delete(dry_run:boolean=False, queue_id:string!) tracker_queues_fields_list(queue_id:string!) tracker_queues_get(expand:string|null=None, queue_id:string!) tracker_queues_group_permissions_get(group_id:integer!, queue_id:string!) tracker_queues_list(all:boolean=False, expand:string|null=None, limit:integer|null=None, next:string|null=None) -tracker_queues_permissions_update(body:object!, queue_id:string!) -tracker_queues_restore(queue_id:string!) -tracker_queues_tags_delete(body:object!, queue_id:string!) +tracker_queues_permissions_update(body:object!, dry_run:boolean=False, queue_id:string!) +tracker_queues_restore(dry_run:boolean=False, queue_id:string!) +tracker_queues_tags_delete(body:object!, dry_run:boolean=False, queue_id:string!) tracker_queues_tags_list(queue_id:string!) tracker_queues_user_permissions_get(queue_id:string!, user_id:string!) -tracker_queues_versions_create(body:object!) -tracker_queues_versions_delete(version_id:integer!) +tracker_queues_versions_create(body:object!, dry_run:boolean=False) +tracker_queues_versions_delete(dry_run:boolean=False, version_id:integer!) tracker_queues_versions_get(fields:string|null=None, version_id:integer!) tracker_queues_versions_list(queue_id:string!) -tracker_queues_versions_update(body:object!, fields:string|null=None, version_id:integer!) -tracker_remotelinks_create(backlink:boolean|null=None, body:object!, issue_key:string!) -tracker_remotelinks_delete(issue_key:string!, link_id:string!) +tracker_queues_versions_update(body:object!, dry_run:boolean=False, fields:string|null=None, version_id:integer!) +tracker_remotelinks_create(backlink:boolean|null=None, body:object!, dry_run:boolean=False, issue_key:string!) +tracker_remotelinks_delete(dry_run:boolean=False, issue_key:string!, link_id:string!) tracker_remotelinks_list(issue_key:string!) -tracker_resolutions_create(body:object!) +tracker_resolutions_create(body:object!, dry_run:boolean=False) tracker_resolutions_list() -tracker_resolutions_update(body:object!, resolution_id:string!, version:integer|null=None) -tracker_sprints_archive(sprint_id:integer!, version:integer|null=None) -tracker_sprints_create(body:object!) -tracker_sprints_delete(sprint_id:integer!) +tracker_resolutions_update(body:object!, dry_run:boolean=False, resolution_id:string!, version:integer|null=None) +tracker_sprints_archive(dry_run:boolean=False, sprint_id:integer!, version:integer|null=None) +tracker_sprints_create(body:object!, dry_run:boolean=False) +tracker_sprints_delete(dry_run:boolean=False, sprint_id:integer!) tracker_sprints_get(sprint_id:integer!) tracker_sprints_list(board_id:integer!) -tracker_sprints_start(sprint_id:integer!, version:integer|null=None) -tracker_sprints_update(body:object!, sprint_id:integer!, version:integer|null=None) -tracker_statuses_create(body:object!) +tracker_sprints_start(dry_run:boolean=False, sprint_id:integer!, version:integer|null=None) +tracker_sprints_update(body:object!, dry_run:boolean=False, sprint_id:integer!, version:integer|null=None) +tracker_statuses_create(body:object!, dry_run:boolean=False) tracker_statuses_list() -tracker_statuses_update(body:object!, status_id:string!, version:integer|null=None) -tracker_transitions_execute(body:object!, issue_key:string!, transition_id:string!) +tracker_statuses_update(body:object!, dry_run:boolean=False, status_id:string!, version:integer|null=None) +tracker_transitions_execute(body:object!, dry_run:boolean=False, issue_key:string!, transition_id:string!) tracker_transitions_list(issue_key:string!) -tracker_triggers_create(body:TriggerCreate!, queue_id:string!) +tracker_triggers_create(body:TriggerCreate!, dry_run:boolean=False, queue_id:string!) tracker_triggers_get(queue_id:string!, trigger_id:integer!) tracker_triggers_list(all:boolean=False, limit:integer|null=None, next:string|null=None, queue_id:string!) -tracker_triggers_update(body:TriggerUpdate!, queue_id:string!, trigger_id:integer!, version:integer|null=None) +tracker_triggers_update(body:TriggerUpdate!, dry_run:boolean=False, queue_id:string!, trigger_id:integer!, version:integer|null=None) tracker_triggers_webhook_log_list(date_from:string|null=None, date_to:string|null=None, issue_id:string|null=None, limit:integer|null=None, queue_id:string!, trigger_id:integer!) tracker_users_get(expand:string|null=None, login_or_id:string!) tracker_users_list(all:boolean=False, expand:string|null=None, limit:integer|null=None, next:string|null=None) -tracker_workflows_actions_update(action_id:string!, body:object!, status:string!, version:integer!, workflow_id:string!) -tracker_workflows_create(body:object!) -tracker_workflows_delete(workflow_id:string!) +tracker_workflows_actions_update(action_id:string!, body:object!, dry_run:boolean=False, status:string!, version:integer!, workflow_id:string!) +tracker_workflows_create(body:object!, dry_run:boolean=False) +tracker_workflows_delete(dry_run:boolean=False, workflow_id:string!) tracker_workflows_get(workflow_id:string!) tracker_workflows_list() tracker_workflows_list_for_queue(queue_id:string!) -tracker_workflows_update(body:object!, version:integer!, workflow_id:string!) -tracker_worklog_create(body:object!, issue_key:string!) -tracker_worklog_delete(issue_key:string!, record_id:string!) -tracker_worklog_import(body:object!, issue_key:string!) +tracker_workflows_update(body:object!, dry_run:boolean=False, version:integer!, workflow_id:string!) +tracker_worklog_create(body:object!, dry_run:boolean=False, issue_key:string!) +tracker_worklog_delete(dry_run:boolean=False, issue_key:string!, record_id:string!) +tracker_worklog_import(body:object!, dry_run:boolean=False, issue_key:string!) tracker_worklog_list(all:boolean=False, issue_key:string!, limit:integer|null=None, next:string|null=None) tracker_worklog_list_global(created_by:string|null=None, created_from:string|null=None, created_to:string|null=None) tracker_worklog_search(body:object!) -tracker_worklog_update(body:object!, issue_key:string!, record_id:string!) -wiki_access_clear(page_id:integer!, prevent_selflock:boolean|null=None) -wiki_access_create(body:object!, page_id:integer!) -wiki_access_delete(access_id:string!, page_id:integer!, prevent_selflock:boolean|null=None) -wiki_access_update(access_id:string!, body:object!, page_id:integer!, prevent_selflock:boolean|null=None) -wiki_attachments_attach(page_id:integer!, session_ids:array!) -wiki_attachments_delete(file_id:integer!, page_id:integer!) +tracker_worklog_update(body:object!, dry_run:boolean=False, issue_key:string!, record_id:string!) +wiki_access_clear(dry_run:boolean=False, page_id:integer!, prevent_selflock:boolean|null=None) +wiki_access_create(body:object!, dry_run:boolean=False, page_id:integer!) +wiki_access_delete(access_id:string!, dry_run:boolean=False, page_id:integer!, prevent_selflock:boolean|null=None) +wiki_access_update(access_id:string!, body:object!, dry_run:boolean=False, page_id:integer!, prevent_selflock:boolean|null=None) +wiki_attachments_attach(dry_run:boolean=False, page_id:integer!, session_ids:array!) +wiki_attachments_delete(dry_run:boolean=False, file_id:integer!, page_id:integer!) wiki_attachments_get(file_id:integer!, page_id:integer!) wiki_attachments_list(all:boolean=False, limit:integer|null=None, next:string|null=None, order_by:string|string|null=None, order_direction:string|string|null=None, page_id:integer!) -wiki_attachments_upload(data:string!, file_name:string!, page_id:integer!) -wiki_comments_create(body:object!, page_id:integer!) -wiki_comments_delete(comment_id:integer!, page_id:integer!) +wiki_attachments_upload(data:string!, dry_run:boolean=False, file_name:string!, page_id:integer!) +wiki_comments_create(body:object!, dry_run:boolean=False, page_id:integer!) +wiki_comments_delete(comment_id:integer!, dry_run:boolean=False, page_id:integer!) wiki_comments_list(all:boolean=False, limit:integer|null=None, next:string|null=None, order_by:string|null=None, order_direction:string|string|null=None, page_id:integer!, status_filter:string|string|null=None) wiki_comments_thread_get(all:boolean=False, comment_id:integer!, limit:integer|null=None, next:string|null=None, page_id:integer!) wiki_comments_thread_list(comment_id:integer!, limit:integer|null=None, page_id:integer!) -wiki_grids_cells_update(body:object!, grid_id:string!) -wiki_grids_clone(body:object!, grid_id:string!) -wiki_grids_columns_create(body:object!, grid_id:string!) -wiki_grids_columns_delete(body:object!, grid_id:string!) -wiki_grids_columns_move(body:object!, grid_id:string!) +wiki_grids_cells_update(body:object!, dry_run:boolean=False, grid_id:string!) +wiki_grids_clone(body:object!, dry_run:boolean=False, grid_id:string!) +wiki_grids_columns_create(body:object!, dry_run:boolean=False, grid_id:string!) +wiki_grids_columns_delete(body:object!, dry_run:boolean=False, grid_id:string!) +wiki_grids_columns_move(body:object!, dry_run:boolean=False, grid_id:string!) wiki_grids_columns_suggest(body:object!, grid_id:string!) -wiki_grids_columns_update(body:object!, column_slug:string!, grid_id:string!) -wiki_grids_create(body:object!) -wiki_grids_delete(grid_id:string!) +wiki_grids_columns_update(body:object!, column_slug:string!, dry_run:boolean=False, grid_id:string!) +wiki_grids_create(body:object!, dry_run:boolean=False) +wiki_grids_delete(dry_run:boolean=False, grid_id:string!) wiki_grids_get(fields:string|null=None, grid_id:string!, only_cols:string|null=None, only_rows:string|null=None, revision:string|null=None, row_filter:string|null=None, sort:string|null=None) -wiki_grids_rows_create(body:object!, grid_id:string!) -wiki_grids_rows_delete(body:object!, grid_id:string!) -wiki_grids_rows_move(body:object!, grid_id:string!) -wiki_grids_rows_update(body:object!, grid_id:string!, row_id:string!) -wiki_grids_update(body:object!, grid_id:string!) +wiki_grids_rows_create(body:object!, dry_run:boolean=False, grid_id:string!) +wiki_grids_rows_delete(body:object!, dry_run:boolean=False, grid_id:string!) +wiki_grids_rows_move(body:object!, dry_run:boolean=False, grid_id:string!) +wiki_grids_rows_update(body:object!, dry_run:boolean=False, grid_id:string!, row_id:string!) +wiki_grids_update(body:object!, dry_run:boolean=False, grid_id:string!) wiki_me_get() wiki_operations_clone_get(task_id:string!) wiki_operations_clone_inline_grid_get(task_id:string!) wiki_operations_move_get(task_id:string!) -wiki_pages_append(body:object!, fields:string|null=None, is_silent:boolean|null=None, page_id:integer!) +wiki_pages_append(body:object!, dry_run:boolean=False, fields:string|null=None, is_silent:boolean|null=None, page_id:integer!) wiki_pages_backlinks_list(all:boolean=False, for_cluster:boolean|null=None, limit:integer|null=None, next:string|null=None, page_id:integer!, show_all:boolean|null=None) -wiki_pages_clone(body:object!, page_id:integer!) -wiki_pages_create(body:object!, fields:string|null=None, is_silent:boolean|null=None) -wiki_pages_delete(page_id:integer!, recursive:boolean|null=None) +wiki_pages_clone(body:object!, dry_run:boolean=False, page_id:integer!) +wiki_pages_create(body:object!, dry_run:boolean=False, fields:string|null=None, is_silent:boolean|null=None) +wiki_pages_delete(dry_run:boolean=False, page_id:integer!, recursive:boolean|null=None) wiki_pages_descendants_list(actuality:string|null=None, all:boolean=False, include_self:boolean|null=None, limit:integer|null=None, next:string|null=None, show_all:boolean|null=None, slug:string!) wiki_pages_descendants_list_by_id(actuality:string|null=None, all:boolean=False, include_self:boolean|null=None, limit:integer|null=None, next:string|null=None, page_id:integer!, show_all:boolean|null=None) wiki_pages_get(raise_on_redirect:boolean|null=None, revision_id:integer|null=None, slug:string!) wiki_pages_get_by_id(fields:string|null=None, page_id:integer!, raise_on_redirect:boolean|null=None, revision_id:integer|null=None) wiki_pages_get_meta(slug:string!) wiki_pages_grids_list(all:boolean=False, limit:integer|null=None, next:string|null=None, order_by:string|string|null=None, order_direction:string|string|null=None, page_id:integer!) -wiki_pages_move(body:object!, validate_only:boolean|null=None) +wiki_pages_move(body:object!, dry_run:boolean=False, validate_only:boolean|null=None) wiki_pages_revisions_list(all:boolean=False, ids:string|null=None, limit:integer|null=None, next:string|null=None, page_id:integer!) wiki_pages_search(body:object!) -wiki_pages_update(allow_merge:boolean|null=None, body:object!, fields:string|null=None, is_silent:boolean|null=None, page_id:integer!) -wiki_recovery_recover(token:string!) +wiki_pages_update(allow_merge:boolean|null=None, body:object!, dry_run:boolean=False, fields:string|null=None, is_silent:boolean|null=None, page_id:integer!) +wiki_recovery_recover(dry_run:boolean=False, token:string!) wiki_resources_list(all:boolean=False, limit:integer|null=None, next:string|null=None, order_by:string|string|null=None, order_direction:string|string|null=None, page_id:integer!, q:string|null=None, types:string|null=None) -wiki_uploadsessions_abort(session_id:string!) -wiki_uploadsessions_abort_all() -wiki_uploadsessions_create(body:object!) -wiki_uploadsessions_finish(session_id:string!) +wiki_uploadsessions_abort(dry_run:boolean=False, session_id:string!) +wiki_uploadsessions_abort_all(dry_run:boolean=False) +wiki_uploadsessions_create(body:object!, dry_run:boolean=False) +wiki_uploadsessions_finish(dry_run:boolean=False, session_id:string!) wiki_uploadsessions_get(session_id:string!) -wiki_uploadsessions_parts_upload(data:string!, part_number:integer!, session_id:string!) +wiki_uploadsessions_parts_upload(data:string!, dry_run:boolean=False, part_number:integer!, session_id:string!) diff --git a/tests/unit/mcp/test_dry_run.py b/tests/unit/mcp/test_dry_run.py new file mode 100644 index 00000000..d19ceed9 --- /dev/null +++ b/tests/unit/mcp/test_dry_run.py @@ -0,0 +1,455 @@ +"""`dry_run` on every tool that writes: one place takes the argument and answers the plan.""" + +import asyncio +import importlib +import inspect +import json +import pkgutil +from types import SimpleNamespace +from typing import Any, cast, get_type_hints + +import mcp.types as mt +import pytest +from fastmcp import Client +from fastmcp.exceptions import ToolError +from fastmcp.server.middleware import MiddlewareContext +from fastmcp.tools import Tool +from mcp.types import ToolAnnotations + +import ycli.yandex +from tests.contract.test_contract import WRITE_CASES, _MCPSession, _serve +from tests.full_server import mcp +from ycli.yandex import mcp as layer +from ycli.yandex.mcp import DRY_RUN_SAID, PLAN_SCHEMA, RO, WRITE, DryRunOffered, new_server +from ycli.yandex.models import secret_keys +from ycli.yandex.registry import SERVICES +from ycli.yandex.tracker.client import TrackerClient + +BOARD = "https://api.tracker.yandex.net/v3/boards/7" +UPDATE = ("tracker_boards_update", {"board_id": 7, "body": {"name": "New"}}) + + +@pytest.fixture +def board(api): + api.add("PATCH", BOARD, json={"id": 7}) + api.add("GET", BOARD, json={"id": 7}) + return api + + +async def _call(name: str, arguments: dict, server=mcp) -> dict: + async with Client(server) as client: + return (await client.call_tool(name, arguments)).structured_content or {} + + +async def test_a_plan_is_answered_and_nothing_is_sent(board): + name, arguments = UPDATE + planned = await _call(name, {**arguments, "dry_run": True}) + assert planned == { + "dry_run": True, + "request": {"method": "PATCH", "url": BOARD, "body": {"name": "New"}}, + } + assert board.calls == [] + # `dry_run=false` is the call it always was. + assert (await _call(name, {**arguments, "dry_run": False}))["id"] == 7 + assert [call.method for call in board.calls] == ["PATCH"] + + +async def test_a_tool_that_only_reads_has_no_such_argument(board): + with pytest.raises(ToolError, match="dry_run: Unexpected keyword argument"): + await _call("tracker_boards_get", {"board_id": 7, "dry_run": True}) + with pytest.raises(ToolError, match="dry_run: true or false"): + await _call(UPDATE[0], {**UPDATE[1], "dry_run": "yes"}) + assert board.calls == [] + + +async def test_calls_side_by_side_do_not_take_each_other_s_flag(board): + """A real write is not stopped by a neighbour's flag; a plan never sends for want of its own.""" + name, arguments = UPDATE + async with Client(mcp) as client: + for _ in range(5): + calls = [ + client.call_tool(name, {**arguments, "dry_run": index % 2 == 0}) + for index in range(8) + ] + answers = [answer.structured_content or {} for answer in await asyncio.gather(*calls)] + assert [answer.get("dry_run", False) for answer in answers] == [True, False] * 4 + assert len(board.calls) == 5 * 4 # the four real ones of each round, and no plan + assert layer._DRY_RUN.get() is None + + +async def test_the_flag_is_gone_after_a_call_that_failed(api): + """A plan that could not be made (the read before the write failed) leaves nothing behind.""" + api.add("PATCH", BOARD, json={"id": 7}) + name, arguments = UPDATE + with pytest.raises(ToolError, match="The arguments do not fit the tool"): + await _call(name, {"board_id": "seven", "body": {}, "dry_run": True}) + assert layer._DRY_RUN.get() is None + assert (await _call(name, arguments))["id"] == 7 and len(api.calls) == 1 + + +def _own_server(): + """A server with two tools that are not ycli's: what the layer does to any tool.""" + server = new_server("own") + + @server.tool(annotations=WRITE) + def unguarded() -> dict: + """A tool that writes with a client it built by itself: the guard is not in it.""" + with TrackerClient(oauth_token="t", organization_id="o") as tracker: + tracker.boards.delete(7) + return {"deleted": 7} + + @server.tool(annotations=WRITE) + def reads_only() -> dict: + """Says it writes, and under `dry_run` only reads, through the guarded client.""" + with layer.client_provider(TrackerClient)() as tracker: + return {"id": tracker.boards.get(7).id} + + return server + + +async def test_a_tool_whose_client_is_not_the_guarded_one_is_never_told_as_a_plan(api): + """What the layer cannot stop it says: the architecture test below keeps it from happening.""" + api.add("DELETE", BOARD, status=204) + with pytest.raises(ToolError, match="cannot be run with dry_run: it ran for real"): + await _call("unguarded", {"dry_run": True}, _own_server()) + assert [call.method for call in api.calls] == ["DELETE"] + + +async def test_a_tool_that_would_write_nothing_says_so_and_gives_no_data(board): + answered = await _call("reads_only", {"dry_run": True}, _own_server()) + assert answered == {"dry_run": True, "request": None} + assert [call.method for call in board.calls] == ["GET"] + + +def _tool_functions(): + """Every tool function of every resource server of ycli, with the server's name.""" + for found in pkgutil.walk_packages(ycli.yandex.__path__, "ycli.yandex."): + if found.name.rpartition(".")[2] != "mcp" or found.ispkg: + continue + server = getattr(importlib.import_module(found.name), "mcp", None) + for tool in asyncio.run(server.list_tools()) if server is not None else []: + yield found.name, tool + + +def test_every_tool_that_writes_takes_its_client_from_the_one_guarded_place(): + """ARCH-3: under `dry_run` no write can go, because no tool has another way to a service.""" + providers = { + getattr(importlib.import_module(f"ycli.yandex.{service.name}.dependencies"), name) + for service in SERVICES + for name in [f"{service.name}_client"] + } + writing, wrong = 0, [] + for module, tool in _tool_functions(): + if not layer._writes(tool): + continue + writing += 1 + given = [ + getattr(parameter.default, "factory", None) + for parameter in inspect.signature(tool.fn).parameters.values() + ] + # The one way in, and no second one beside it in the body of the tool. + if not providers.intersection(given) or "build_client" in inspect.getsource(tool.fn): + wrong.append(f"{module}:{tool.name}") + assert not wrong + assert writing == 260 + + +async def test_a_secret_of_a_body_is_masked_in_the_plan_of_a_tool(api, monkeypatch): + monkeypatch.delenv("YANDEX_ID_OAUTH_TOKEN") # DataLens takes an IAM token only + monkeypatch.setenv("YANDEX_CLOUD_IAM_TOKEN", "t") + monkeypatch.setenv("YANDEX_CLOUD_ORGANIZATION_ID", "c") + body = {"name": "db", "type": "postgres", "password": "hunter2", "workbookId": "w1"} + planned = await _call("datalens_connections_create", {"connection": body, "dry_run": True}) + assert "hunter2" not in str(planned) and api.calls == [] + assert planned["request"]["body"]["password"] == "***" + + +async def test_dry_run_is_listed_on_every_tool_that_writes_and_on_no_other(): + async with Client(mcp) as client: + tools = await client.list_tools() + offered = {tool.name for tool in tools if "dry_run" in tool.input_schema["properties"]} + writing = {tool.name for tool in tools if tool.annotations.read_only_hint is False} + assert offered == writing and len(offered) == 260 + said = { + tool.input_schema["properties"]["dry_run"]["description"] + for tool in tools + if tool.name in offered + } + assert said == {DRY_RUN_SAID} + + +async def test_the_plan_stands_beside_the_tool_s_own_answer_in_its_output_schema(): + server = new_server("own") + + @server.tool(annotations=WRITE) + def rename(name: str) -> dict[str, str]: + """Rename it.""" + return {"name": name} + + @server.tool(annotations=RO) + def read() -> dict[str, str]: + """Read it.""" + return {} + + @server.tool(annotations=WRITE, output_schema=None) + def touch() -> None: + """Answers nothing, and has no schema to put a plan beside.""" + + @server.tool(annotations=WRITE) + def retag(tags: list[str]) -> list[str]: + """Answers a list, which FastMCP puts under `result`.""" + with layer.client_provider(TrackerClient)() as tracker: + tracker.boards.delete(7) + return tags + + tools = {tool.name: tool for tool in await server.list_tools()} + own = tools["read"].output_schema + # The plan first: it takes no other key, so an answer of the tool is never read as one. + assert tools["rename"].output_schema == {"type": "object", "anyOf": [PLAN_SCHEMA, own]} + assert tools["touch"].output_schema is None + assert "dry_run" in tools["touch"].parameters["properties"] + wrapped = tools["retag"].output_schema + assert wrapped is not None + assert wrapped["x-fastmcp-wrap-result"] is True and wrapped["type"] == "object" + assert wrapped["properties"]["result"]["anyOf"][0] == PLAN_SCHEMA + # A client that validates what it gets takes both answers of both kinds of tool. + async with Client(server) as client: + assert (await client.call_tool("rename", {"name": "n"})).data == {"name": "n"} + planned = await client.call_tool("retag", {"tags": ["a"], "dry_run": True}) + assert planned.structured_content == { + "result": {"dry_run": True, "request": {"method": "DELETE", "url": BOARD, "body": None}} + } + assert "dry_run" not in tools["read"].parameters["properties"] + # Passed through twice, as a server mounted in another is: nothing changes. + [again] = await DryRunOffered().list_tools([tools["rename"]]) + assert again is tools["rename"] + assert await DryRunOffered().get_tool("ghost", lambda name, *, version=None: _none()) is None + + +async def _none() -> None: + return None + + +@pytest.mark.parametrize("ends", ["raises", "returns"]) +async def test_the_flag_is_set_for_the_one_call_and_for_nothing_after_it(ends): + """In the very context the call ran in: a server that served two calls in one would leak.""" + tool = Tool.from_function( + lambda: {}, name="write", annotations=ToolAnnotations.model_validate(WRITE) + ) + + async def get_tool(name: str) -> Tool: + return tool + + seen = [] + + async def call_next(context): + asked = layer._DRY_RUN.get() + seen.append((asked is not None, context.message.arguments)) + if ends == "raises": + raise ToolError("the service refused") + assert asked is not None + asked.guarded = True + return None + + server = SimpleNamespace(fastmcp=SimpleNamespace(get_tool=get_tool)) + message = mt.CallToolRequestParams(name="write", arguments={"a": 1, "dry_run": True}) + context: Any = MiddlewareContext(message=message, fastmcp_context=cast("Any", server)) + if ends == "raises": + with pytest.raises(ToolError, match="the service refused"): + await layer.DryRun().on_call_tool(context, call_next) + else: + planned = await layer.DryRun().on_call_tool(context, call_next) + assert planned.structured_content == {"dry_run": True, "request": None} + assert seen == [(True, {"a": 1})] # set for the call, and the argument taken out of it + assert layer._DRY_RUN.get() is None + + +async def test_a_plan_that_would_grant_access_says_so(api): + """A dry run of a grant tells the caller what the real call will be asked about.""" + body = {"role": "editor", "user": {"uid": "9001"}} + planned = await _call("wiki_access_create", {"page_id": 7, "body": body, "dry_run": True}) + assert planned["grants_access"] is True and planned["request"]["method"] == "POST" + assert "grants_access" not in await _call(UPDATE[0], {**UPDATE[1], "dry_run": True}) + assert api.calls == [] + + +def _references(schema: Any) -> list[str]: + """Every `$ref` of ``schema``, at any depth.""" + if isinstance(schema, dict): + named = schema.get("$ref") + own = [named] if isinstance(named, str) else [] + return own + [found for value in schema.values() for found in _references(value)] + if isinstance(schema, list): + return [found for value in schema for found in _references(value)] + return [] + + +def test_every_reference_of_the_output_schema_of_a_tool_that_writes_resolves(): + """The definitions a tool's schema refers to stay where its references look for them. + + The plan stands beside the tool's own schema; nested whole, that schema would keep its + `$defs` under the union and its `$ref`s would point nowhere (#576). + """ + looked, lost = 0, [] + for module, tool in _tool_functions(): + schema = tool.output_schema + if not layer._writes(tool) or schema is None: + continue + looked += 1 + for reference in _references(schema): + assert reference.startswith("#/$defs/"), reference + if reference.removeprefix("#/$defs/") not in schema.get("$defs", {}): + lost.append(f"{module}:{tool.name} {reference}") + assert not lost[:5], f"{len(lost)} references point nowhere" + assert looked > 200 + + +SERVERS = {service.name: service.mcp_server() for service in SERVICES} +# The function of every tool, by the name the root server gives it: `_`. +FUNCTIONS = {f"{module.split('.')[2]}_{tool.name}": tool.fn for module, tool in _tool_functions()} + + +def _listed(server) -> dict: + return {tool.name: tool for tool in asyncio.run(server.list_tools())} + + +TOOLS = {name: _listed(server) for name, server in SERVERS.items()} + + +def _answers(case, wanted: str) -> bool: + """Whether the tool of ``case`` has ``wanted`` at the root of its output schema.""" + assert case.mcp is not None + tool = TOOLS[case.domain].get(case.mcp[0].removeprefix(f"{case.domain}_")) + return tool is not None and wanted in (tool.output_schema or {}) + + +def _function(name: str): + """The function behind the tool ``name`` of the root server.""" + return FUNCTIONS[name] + + +PLANNED_AND_SENT = [ + case + for service in SERVICES + for wanted in ("$defs", "x-fastmcp-wrap-result") + for case in [ + next( + ( + case + for case in WRITE_CASES + if case.domain == service.name and _answers(case, wanted) + ), + None, + ) + ] + if case is not None +] + + +@pytest.mark.parametrize("case", PLANNED_AND_SENT, ids=[case.id for case in PLANNED_AND_SENT]) +async def test_a_client_that_validates_takes_the_answer_and_the_plan(case, monkeypatch): + """Both answers of a tool fit the schema a validating client holds them to. + + A service's server run by itself lists output schemas, and FastMCP's client checks every + answer against them: a tool whose schema has definitions, and one that answers a list. + """ + assert case.mcp is not None + name, arguments = case.mcp + local = name.removeprefix(f"{case.domain}_") + for variable, value in case.env.items(): + monkeypatch.setenv(variable, value) + api = _serve(monkeypatch, case) + async with Client(SERVERS[case.domain]) as client: + listed = {tool.name: tool for tool in await client.list_tools()} + assert listed[local].output_schema is not None + planned = await client.call_tool(local, {**arguments, "dry_run": True}) + plan = planned.structured_content or {} + assert plan.get("result", plan)["dry_run"] is True + assert all(sent.method == "GET" for sent in api.calls) + answered = await client.call_tool(local, dict(arguments)) + assert not answered.is_error and len(api.calls) >= 1 + + +async def test_a_part_of_the_reply_of_a_tool_that_writes_is_still_found_by_schema_get(): + async with Client(mcp) as client: + found = await client.call_tool( + "schema_get", {"tool": "tracker_boards_update", "name": "Calendar"} + ) + assert not found.is_error and "properties" in str(found.structured_content) + + +NESTED = ("dry_run", "dryRun", "dry-run") + + +def _with_inside(arguments: dict, key: str) -> list[dict]: + """``arguments`` with ``key: true`` put inside each object among them, at two depths.""" + made = [] + for name, value in arguments.items(): + if isinstance(value, dict): + made.append({**arguments, name: {**value, key: True}}) + made.append({**arguments, name: {**value, "deeper": [{key: True}]}}) + return made + + +@pytest.mark.parametrize("case", WRITE_CASES, ids=[case.id for case in WRITE_CASES]) +async def test_dry_run_inside_an_argument_is_refused_and_nothing_is_sent(case, monkeypatch): + """One who nests it believes they are planning: that belief must not end in a write.""" + assert case.mcp is not None + name, arguments = case.mcp + for variable, value in case.env.items(): + monkeypatch.setenv(variable, value) + api = _serve(monkeypatch, case) + tried = [made for key in NESTED for made in _with_inside(dict(arguments), key)] + async with Client(mcp) as client: + for made in tried: + refused = await client.call_tool(name, made, raise_on_error=False) + assert refused.is_error, made + assert "is the tool's own argument: give it beside" in refused.content[0].text + assert api.calls == [] + + +async def test_a_plan_is_no_error_in_the_log(board, caplog): + """Two plans, and not a line that says a tool failed, nor a traceback of the signal.""" + caplog.set_level("DEBUG") + name, arguments = UPDATE + for _ in range(2): + await _call(name, {**arguments, "dry_run": True}) + assert "Error calling tool" not in caplog.text and "RequestPlanned" not in caplog.text + assert not [record for record in caplog.records if record.exc_info] + + +def test_no_secret_given_to_a_tool_comes_back_in_its_plan(monkeypatch): + """Not by the function that masks: the literal value given is looked for in the answer. + + The parity of the two surfaces cannot see masking switched off, since both print the plan + with one function. No contract case gives a secret, so one is put in: for every write case + whose argument is a model that marks keys as secret, each such key is given a value of its + own, the call is planned, and that value must not be in what comes back. + """ + session, kept, unplaced = _MCPSession(), set(), set() + try: + for case in WRITE_CASES: + assert case.mcp is not None + name, arguments = case.mcp + hints = get_type_hints(_function(name)) + for argument, value in arguments.items(): + model = hints.get(argument) + if not isinstance(value, dict) or not isinstance(model, type): + continue + for key in sorted(secret_keys(model)): + given = f"s3cr3t-of-{key}" + for variable, set_to in case.env.items(): + monkeypatch.setenv(variable, set_to) + _serve(monkeypatch, case) + made = {**arguments, argument: {**value, key: given}, "dry_run": True} + try: + answered = json.dumps(session.call(name, made)) + except ToolError: + unplaced.add((name, key)) # the key lies deeper in this model + continue + assert given not in answered, f"{name}: {key} came back in the plan" + assert "***" in answered, f"{name}: {key} is not in the plan at all" + kept.add((name, key)) + finally: + session.close() + assert len(kept) >= 10, sorted(unplaced)