xtiles_set_page_layout
DestructiveIdempotent
Reposition tiles on an xTiles page (view). Provide viewId and a list of tiles with their new grid positions (x, y, w, h). Only the listed tiles move; the rest keep their current position. Coordinates use the xTiles grid — (x, y) is the top-left corner and (w, h) the size, in grid cells. Out-of-bounds or overlapping positions are rejected. Returns the resulting full layout. Tip: call xtiles_get_page_layout first to get tile IDs and current positions. Which colours, styles, sizes and positions to use: xtiles://guide/markdown/design.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tiles | Yes | Tiles to reposition. Each tile_id must be unique; tiles you omit keep their current position. Positions are validated by the server — out-of-bounds or overlapping tiles are rejected. | |
| viewId | Yes | View ID of an xTiles page. You can also extract it from a page URL — it is the last path segment, whatever the domain, e.g. `https://xtiles.app/6740858058af8a09bf6096e6` → viewId is `6740858058af8a09bf6096e6`. Discover IDs programmatically via `xtiles_list_projects` or `xtiles_get_project_content`. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| grid | Yes | ||
| tiles | Yes | ||
| view_id | Yes |