Skip to content

Wiki MCP tools

56 tools.

wiki_me_get

Get current Wiki user · read-only

The authenticated Yandex Wiki user (a safe auth probe).

wiki_pages_get

Get Wiki page · read-only

The page's markdown body for SLUG.

Parameter Type Required Description
slug string yes Wiki page slug (its path), e.g. users/something/abc.
revision_id integer or null Show this past revision (an id from pages_revisions_list).
raise_on_redirect boolean or null Fail if the page is a redirect instead of following it.

wiki_pages_get_meta

Get Wiki page metadata · read-only

Page metadata for SLUG (attributes + owner).

Parameter Type Required Description
slug string yes Wiki page slug (its path), e.g. users/something/abc.

wiki_pages_descendants_list

List Wiki page descendants · read-only

All descendant refs under SLUG, auto-paginated.

Capped at the configured item cap unless limit is given; narrow by SLUG for large trees.

Parameter Type Required Description
slug string yes Wiki page slug (its path), e.g. users/something/abc.
limit integer or null Max descendant refs to return; omitted means the configured cap of a tool (YCLI__HTTP__MAX_TOOL_ITEMS).
all boolean Return everything, ignoring the cap. A long listing is better taken in pieces: limit, then next.
next string or null Go on from where an earlier call stopped, with the next it returned: the token carries its listing; give what is required again, and nothing else but the limit.
include_self boolean or null Also return the ancestor page itself.
show_all boolean or null The API's show_all flag.
actuality string or null Only the pages in this state: actual or obsolete.

wiki_pages_grids_list

List Wiki page grids · read-only

Dynamic tables (grids) attached to a page id, auto-paginated (drains next_cursor).

Each grid ref is a UUID id + title + created_at. Capped at the configured item cap unless limit is given. Reads a page's numeric id — pair with pages_get_meta / pages_descendants_list (whose refs carry the ids) to find one.

Parameter Type Required Description
page_id integer yes Numeric page id whose grids to list.
limit integer or null Max grids (omitted: the configured cap).
all boolean Return everything, ignoring the cap. A long listing is better taken in pieces: limit, then next.
next string or null Go on from where an earlier call stopped, with the next it returned: the token carries its listing; give what is required again, and nothing else but the limit.
order_by title · created_at or string or null Sort field.
order_direction asc · desc or string or null Sort direction for order_by.

wiki_pages_get_by_id

Get Wiki page by id · read-only

A single page by its numeric id — the id-based twin of pages_get/pages_get_meta.

Use it when you hold a numeric page id (e.g. from a descendants listing or a write's response) instead of the slug. fields follows the standard Wiki selector rules: without it the response carries id/slug/title only; ask for content or attributes explicitly.

Parameter Type Required Description
page_id integer yes Numeric page id to fetch.
fields string or null Extra blocks (CSV), e.g. content,attributes,breadcrumbs. Omitted = id/slug/title only.
revision_id integer or null Show this past revision (an id from pages_revisions_list).
raise_on_redirect boolean or null Fail if the page is a redirect instead of following it.

wiki_pages_descendants_list_by_id

List Wiki page descendants by id · read-only

All descendant page refs under a numeric page id, auto-paginated.

The id-based twin of pages_descendants_list. Capped at the configured item cap unless limit is given; each ref carries the child's numeric id and permanent slug.

Parameter Type Required Description
page_id integer yes Numeric page id whose subtree to list.
limit integer or null Max refs (omitted: the configured cap).
all boolean Return everything, ignoring the cap. A long listing is better taken in pieces: limit, then next.
next string or null Go on from where an earlier call stopped, with the next it returned: the token carries its listing; give what is required again, and nothing else but the limit.
include_self boolean or null Also return the ancestor page itself.
show_all boolean or null The API's show_all flag.
actuality string or null Only the pages in this state: actual or obsolete.

wiki_pages_create

Create Wiki page · write

Create a wiki page at body.slug (POST /pages).

Treat the slug as permanent: pages_move can rename the page later, but the old address then answers 404 and links to it break, so pick the slug carefully. Returns the created page (its numeric id drives the id-based tools and every subsequent write). E.g. {"body": {"slug": "data/x", "title": "X", "content": "# X"}}.

Parameter Type Required Description
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

Update Wiki page · idempotent write

Change a wiki page by numeric id: only the fields set in body change.

body.content REPLACES the whole text — to add to an existing page use pages_append instead. The Wiki API updates via POST, not PATCH (PATCH returns 405); the SDK already handles that quirk. Repeating the same call yields the same page state (idempotent). E.g. {"page_id": 7, "body": {"title": "New name"}}.

Parameter Type Required Description
page_id integer yes Numeric id of the page to update.
body object yes Typed request body for POST /pages/{id}: only the fields set are changed. A page's address is not among them: :class:PageMove renames or relocates a page.
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

Delete Wiki page · destructive write

Delete a wiki page by numeric id (DELETE /pages/{id}).

KEEP the returned recovery_token — it is the only handle to undo the delete (redeem it with recovery_recover). Deleting removes the page's descendants' anchor too, so double-check the id (pages_get_by_id) before calling.

Parameter Type Required Description
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

Append content to Wiki page · write

Append a YFM fragment to a wiki page without rewriting the whole body.

Unlike pages_update (full replace), this adds body.content at the chosen spot: body.body.location (top/bottom of the page), a numbered body.section, or a named text body.anchor. Returns the updated page.

Parameter Type Required Description
page_id integer yes Numeric id of the page to append to.
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

Clone Wiki page · write

Copy a page to a new address (POST /pages/{id}/clone — asynchronous).

Cloning leaves the original where it is; to give the page itself a new slug use pages_move. The call returns a deferred operation reference — poll operations_clone_get with the returned operation.id until it reaches a terminal status.

Parameter Type Required Description
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

Move Wiki page · write

Move or rename pages (POST /pages/move — asynchronous; undocumented by Yandex).

The only way to give a page a new slug. The call returns a deferred operation reference — poll operations_move_get with the returned operation.id until it reaches a terminal status. A page moves with its subtree and links to the old address may stop working, so try validate_only=true first: it validates the request, applies nothing, and its operation id cannot be polled. Yandex does not document this operation (it is in the live OpenAPI only) and may change it.

Parameter Type Required Description
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

List Wiki page revisions · read-only

Saved revisions of a page, auto-paginated (GET /pages/{id}/revisions).

Each revision has an id (what GET /pages takes as revision_id), its author, created_at, page_type and publication state. Yandex does not document this operation (it is in the live OpenAPI only) and may change it.

Parameter Type Required Description
page_id integer yes Numeric page id whose revisions to list.
ids string or null Only these revision ids (comma separated).
limit integer or null Max revisions (omitted: the configured cap).
all boolean Return everything, ignoring the cap. A long listing is better taken in pieces: limit, then next.
next string or null Go on from where an earlier call stopped, with the next it returned: the token carries its listing; give what is required again, and nothing else but the limit.

List Wiki page backlinks · read-only

Refs (id and slug) of the pages that link to a page (GET /pages/{id}/backlinks).

Auto-paginated. Yandex does not document this operation (it is in the live OpenAPI only) and may change it.

Parameter Type Required Description
page_id integer yes Numeric id of the page that is linked to.
for_cluster boolean or null Links to the page's whole subtree, not just the page.
show_all boolean or null The API's show_all flag (undocumented; no effect seen live).
limit integer or null Max refs (omitted: the configured cap).
all boolean Return everything, ignoring the cap. A long listing is better taken in pieces: limit, then next.
next string or null Go on from where an earlier call stopped, with the next it returned: the token carries its listing; give what is required again, and nothing else but the limit.

Search Wiki · read-only

Full-text search over wiki pages and files; returns one page of hits.

Each hit has the page slug (read it with pages_get), title, a content snippet, the type and modified_at. body.filters narrows the search by type, authors, cluster (a page slug), created_at / modified_at (a window with both from and to) and show_obsolete. For the next page pass next_cursor back as body.cursor; stop at the first page without hits, because next_cursor stays set after an empty page. A new page can take seconds to appear in the index. E.g. {"body": {"query": "roadmap", "limit": 5}}.

Parameter Type Required Description
body object yes Body of POST /search: the query, filters and one page of the results.

wiki_access_create

Grant Wiki page access · write

Grant a user or a group a role on a wiki page; returns the new access entry.

A user who already holds a personal access is refused: change it with access_update. Read the current accesses with pages_get_by_id and fields="access_policy,access_lists".

Grants access: a client that honours the mark asks a person on every call.

Parameter Type Required Description
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

Update Wiki page access · idempotent write

Change the role or reach of one access entry on a wiki page.

The page owner's own entry cannot be changed.

Grants access: a client that honours the mark asks a person on every call.

Parameter Type Required Description
page_id integer yes Numeric id of the page.
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

Revoke Wiki page access · destructive write

Revoke one access entry on a wiki page — the holder loses that grant at once.

The page owner's own entry cannot be revoked.

Parameter Type Required Description
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

Clear Wiki page accesses · destructive write

Revoke every personal access on a wiki page except the owner's.

Everyone but the owner falls back to the page's access policy. Irreversible: the revoked entries are not kept.

Parameter Type Required Description
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

List Wiki comments · read-only

Comments on a page id, auto-paginated (drains the next_cursor internally).

Capped at the configured item cap unless limit is given. Pair with pages_get_meta (its attributes.comments_count tells you how many exist).

Parameter Type Required Description
page_id integer yes Numeric page id, from pages_get_meta or a page ref.
limit integer or null Max comments to return; omitted means the configured cap of a tool (YCLI__HTTP__MAX_TOOL_ITEMS).
all boolean Return everything, ignoring the cap. A long listing is better taken in pieces: limit, then next.
next string or null Go on from where an earlier call stopped, with the next it returned: the token carries its listing; give what is required again, and nothing else but the limit.
order_by string or null Sort field: created_at.
order_direction asc · desc or string or null Sort direction for order_by.
status_filter resolved · unresolved or string or null Keep only the comments in this state.

wiki_comments_thread_list

List Wiki comment thread · read-only

A comment and its replies, reconstructed from the page's comment list.

The Wiki /thread endpoint (comments_thread_get) is dead (returns no replies), so this fetches every comment on the page and chains parent_id from the target: the comment comes first, then its descendants in depth-first order. Capped at the configured item cap unless limit is given. Use comments_list first to discover a root comment id, then this to read its thread.

Parameter Type Required Description
page_id integer yes Numeric page id the comment lives on.
comment_id integer yes Root comment id whose reply thread to fetch.
limit integer or null Max replies (omitted: the configured cap).

wiki_comments_thread_get

Get Wiki comment thread from the server · read-only

The thread of a comment as the Wiki server returns it — an empty list for every real thread.

Checked live on 2026-10-02: the server's /thread endpoint has no replies to give, for a root comment or a reply, plain or inline. Use comments_thread_list, which rebuilds the thread from the page's comment list.

Parameter Type Required Description
page_id integer yes Numeric page id the comment lives on.
comment_id integer yes Comment id whose server-side thread to fetch.
limit integer or null Max comments (omitted: the configured cap).
all boolean Return everything, ignoring the cap. A long listing is better taken in pieces: limit, then next.
next string or null Go on from where an earlier call stopped, with the next it returned: the token carries its listing; give what is required again, and nothing else but the limit.

wiki_comments_create

Create Wiki comment · write

Add a comment (or a threaded reply) to a wiki page.

Pass body.parent_id to reply to an existing comment — find ids with comments_list. Returns the created comment with its numeric id.

Parameter Type Required Description
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

Delete Wiki comment · destructive write

Delete a comment from a wiki page — irreversible (no recovery token).

Returns the page's remaining comments_count. Verify the target with comments_list / comments_thread_list first: deleting a parent orphans its replies' threading.

Parameter Type Required Description
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

List Wiki attachments · read-only

Attachments (name, size, mime type) on a page id, auto-paginated (drains next_cursor).

Capped at the configured item cap unless limit is given. This is the list surface; downloading an attachment's bytes is CLI/SDK-only (binary blobs are not an MCP payload).

Parameter Type Required Description
page_id integer yes Numeric page id, from pages_get_meta or a page ref.
limit integer or null Max attachments to return; omitted means the configured cap of a tool (YCLI__HTTP__MAX_TOOL_ITEMS).
all boolean Return everything, ignoring the cap. A long listing is better taken in pieces: limit, then next.
next string or null Go on from where an earlier call stopped, with the next it returned: the token carries its listing; give what is required again, and nothing else but the limit.
order_by name · size · created_at or string or null Sort field.
order_direction asc · desc or string or null Sort direction for order_by.

wiki_attachments_get

Get Wiki attachment · read-only

Metadata of one attachment (GET /pages/{id}/attachments/{file_id}).

Name, size, MIME type, download URL, whether a preview exists and the virus-check status. Yandex does not document this operation (it is in the live OpenAPI only) and may change it. Fetching the bytes (download, preview) is CLI/SDK-only.

Parameter Type Required Description
page_id integer yes Numeric id of the page the file is attached to.
file_id integer yes Numeric id of the attachment.

wiki_attachments_attach

Attach uploaded files to Wiki page · write

Attach file(s) from finished upload sessions to a wiki page.

The final step of the upload pipeline: create the session (uploadsessions_create), send the bytes (uploadsessions_parts_upload), close it (uploadsessions_finish), then attach here. For one small file, attachments_upload runs the whole pipeline in a single call. Returns the newly-attached files.

Parameter Type Required Description
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

Upload file to Wiki page · write

Upload one small file and attach it to a wiki page in a single call.

Runs the whole pipeline end to end: opens an upload session sized to data, PUTs the bytes as a single part, finishes the session, and attaches it to the page. Small-file path — for large files drive uploadsessions_create / uploadsessions_parts_upload (chunked) / uploadsessions_finish + attachments_attach yourself. Returns the newly-attached files.

Parameter Type Required Description
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

Delete Wiki attachment · destructive write

Delete an attachment from a wiki page — irreversible (no recovery token).

The API answers 204 No Content; a typed acknowledgement is returned instead. Find file_id with attachments_list and double-check it before calling.

Parameter Type Required Description
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

List Wiki page resources · read-only

A page's resources — attachments AND grids — as {type, item} envelopes, auto-paginated.

The unified single-pass listing over what attachments_list and pages_grids_list expose separately (drains next_cursor internally). Capped at the configured item cap unless limit is given; narrow with q (title) or types (attachment,grid).

Parameter Type Required Description
page_id integer yes Numeric page id whose resources to list.
limit integer or null Max resources (omitted: the configured cap).
all boolean Return everything, ignoring the cap. A long listing is better taken in pieces: limit, then next.
next string or null Go on from where an earlier call stopped, with the next it returned: the token carries its listing; give what is required again, and nothing else but the limit.
q string or null Optional title search filter.
types string or null Comma-separated kinds to include: attachment,grid.
order_by name_title · created_at or string or null Sort field.
order_direction asc · desc or string or null Sort direction for order_by.

wiki_recovery_recover

Restore deleted Wiki page · write

Undo a page delete: redeem a recovery_token and bring the page back.

pages_delete returns the token — it is the only handle to the deleted page. Returns the restored page's numeric id and permanent slug, and pages_count, how many pages came back (the page and those under it). No request body; the token in 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

Get Wiki grid · read-only

A single dynamic table (grid) by its UUID, with structure, rows and revision.

Grids are the modern dynamic tables attached to a page; find a grid's id with pages_grids_list. Use row_filter/only_cols/only_rows/sort to narrow large grids server-side, and fields=attributes,user_permissions for extra blocks. The returned revision is what any subsequent write must send back.

Parameter Type Required Description
grid_id string yes The grid's permanent UUID4 id.
fields string or null Extra blocks to include (CSV), e.g. attributes,user_permissions.
row_filter string or null Server-side row filter, e.g. [slug] ~ wiki.
only_cols string or null Return only these column slugs (CSV).
only_rows string or null Return only these row ids (CSV).
revision string or null Load this past revision instead of the current one.
sort string or null Row sort, e.g. slug,-slug2.

wiki_grids_create

Create Wiki grid · write

Create an empty dynamic table (grid) as a resource of a page.

A new grid has no rows or columns — add them afterwards with grids_columns_create and grids_rows_create. Returns the created grid; every subsequent write sends its revision back.

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

Update Wiki grid · idempotent write

Rename or re-sort a grid (POST-not-PATCH quirk handled by the SDK).

body.revision must match the grid's current revision (read it off grids_get); a mismatch fails the write. Returns the grid's new revision.

Parameter Type Required Description
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

Delete Wiki grid · destructive write

Delete a grid — irreversible (grids have NO recovery token, unlike pages).

Verify the target with grids_get first. The API answers 204 No Content; the 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

Add Wiki grid rows · write

Insert rows into a grid at a position (default: append at the end).

Column slugs come from grids_get's structure block. Returns the created rows plus the grid's new revision.

Parameter Type Required Description
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

Remove Wiki grid rows · destructive write

Delete rows from a grid by id — irreversible.

A rare DELETE-with-body: ids and revision travel in the JSON body. Find row ids with grids_get. Returns the grid's new revision.

Parameter Type Required Description
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

Move Wiki grid rows · write

Reorder rows inside a grid (move a run of consecutive rows to a new position).

Returns the grid's new revision.

Parameter Type Required Description
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

Add Wiki grid columns · write

Add columns to a grid at a position (default: append after the last column).

Each column needs a title and a type (string, number, select, staff, date, checkbox, ticket_field, …); type-specific fields such as select_options shape it further. Returns the grid's new revision.

Parameter Type Required Description
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

Remove Wiki grid columns · destructive write

Delete columns from a grid by slug — irreversible (every cell in them is lost).

A rare DELETE-with-body: slugs and revision travel in the JSON body. Returns the grid's new revision.

Parameter Type Required Description
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

Move Wiki grid columns · write

Reorder columns inside a grid (move a run of consecutive columns to a new position).

Returns the grid's new revision.

Parameter Type Required Description
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

Update Wiki grid cells · idempotent write

Set the value of individual grid cells (addressed by row id + column slug).

Repeating the same call sets the same values (idempotent). Returns the updated cells plus the grid's new revision.

Parameter Type Required Description
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

Clone Wiki grid · write

Copy a grid onto another page (POST /grids/{id}/clone — asynchronous).

body.with_data=true copies the rows as well as the structure. Returns a deferred operation reference — poll operations_clone_inline_grid_get with the returned operation.id until it reaches a terminal status.

Parameter Type Required Description
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

Suggest Wiki grid column slug · read-only

Check whether a column slug is free in a grid and get free alternatives (read-only).

The call is a POST but changes nothing. Yandex does not document this operation (it is in the live OpenAPI only) and may change it.

Parameter Type Required Description
grid_id string yes The grid's permanent UUID4 id.
body object yes slug to check, or a title to turn into a slug and check.

wiki_grids_columns_update

Update Wiki grid column · idempotent write

Edit a grid column in place: only the fields sent change; its type and slug stay.

Repeating the same call leaves the same column (idempotent). revision is accepted but not enforced, and every call moves the grid's revision on. Returns the grid's new revision and the column as saved. Yandex does not document this operation (it is in the live OpenAPI only) and may change it.

Parameter Type Required Description
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

Update Wiki grid row · idempotent write

Pin or colour one grid row (cell values are set by grids_cells_update).

Repeating the same call leaves the same row (idempotent). The reply is a bare acknowledgement without the new revision (read it with grids_get); revision is accepted but not enforced. Yandex does not document this operation (it is in the live OpenAPI only) and may change it.

Parameter Type Required Description
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

Get Wiki page-clone status · read-only

Status of an async page-clone operation — poll it until it finishes.

pages clone (a CLI/SDK write) returns an operation.id; pass it here and re-read until status is success or failed. On success the result.page names the clone. The sibling operations_clone_inline_grid_get polls inline-grid clones instead.

Parameter Type Required Description
task_id string yes Task id from a page-clone trigger (operation.id).

wiki_operations_clone_inline_grid_get

Get Wiki grid-clone status · read-only

Status of an async inline-grid-clone operation — poll it until it finishes.

grids clone (a CLI/SDK write) returns an operation.id; pass it here and re-read until status is success or failed. On success the result.grid_id names the copy. The sibling operations_clone_get polls page clones instead.

Parameter Type Required Description
task_id string yes Task id from a grid-clone trigger (operation.id).

wiki_operations_move_get

Get Wiki page-move status · read-only

Status of an async page-move operation — poll it until it finishes.

pages_move returns an operation.id; pass it here and re-read until status is success or failed. On success the result.page_count says how many pages moved. This operation is undocumented by Yandex (it is in the live OpenAPI only) and may change.

Parameter Type Required Description
task_id string yes Task id from a page-move trigger (operation.id).

wiki_uploadsessions_get

Get Wiki upload session · read-only

Current state of a Wiki file upload session by its UUID (status, file name/size, storage).

Poll this to watch a session move not_started → in_progress → finished before the file is attached to a page.

Parameter Type Required Description
session_id string yes UUID4 of the upload session to inspect.

wiki_uploadsessions_create

Create Wiki upload session · write

Open an upload session — step 1 of the Wiki file-upload pipeline.

The returned session_id addresses the session for uploadsessions_parts_upload / uploadsessions_finish. For a single small file, attachments_upload runs the whole 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

Upload Wiki file part · idempotent write

Upload one file part to an open session — step 2 of the upload pipeline.

The base64 data is decoded and sent as raw application/octet-stream bytes. Parts may be 5-16 MB except the last; a small file fits in a single part_number=1 call. Returns the session (poll status via uploadsessions_get).

Parameter Type Required Description
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

Finish Wiki upload session · write

Close an upload session after its last part — step 3 of the upload pipeline.

Only a finished session can be attached to a page (attachments_attach). Returns the 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

Abort Wiki upload session · destructive write

Cancel one in-progress upload session, discarding its uploaded parts.

Frees the session's quota; the session cannot be resumed afterwards. Returns the 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

Abort all Wiki upload sessions · destructive write

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).