xtiles_update_page
DestructiveIdempotent
Update a page in the project's tab bar — rename it, recolour it and/or archive it: provide title, color, is_archived, or any combination. Get viewId from xtiles_get_project_structure. Only pages listed by xtiles_get_project_structure are valid here. A planner day is not one of them: the API answers 404 for a page in another project and 409 for one inside this project’s planner. Read a planner day with xtiles_get_planner_content and write to it with xtiles_create_tiles_from_markdown_in_project_planner. The API answers with no body on success, so there is nothing to return beyond confirmation.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| color | No | Colour — one of: DEFAULT, LAVENDER, RED, ORANGE, YELLOW, GREEN, DARK_GREEN, LIGHT_BLUE, BLUE, PURPLE, PINK, GRAY, BEIGE. Omit to leave the colour unchanged. `DEFAULT` sets that specific colour; it does not clear/reset the colour — there is currently no way to remove a colour once set. Tabs follow a scheme of one or two colours (an ordinary colour on every tab, plus an accent for the main page and groups where there is one, both taken from the project's tile colours); change one tab at a time, each finishing before the next. Scheme and mapping: `xtiles://guide/markdown/design`. | |
| title | No | New title for the page. Omit to leave the title unchanged. | |
| viewId | Yes | View ID of the page to update (from xtiles_get_project_structure). | |
| projectId | Yes | Project ID (use xtiles_list_projects to discover). | |
| is_archived | No | Archive (true) or unarchive (false) — hides/unhides the item in the tab bar without deleting it. Omit to leave the archived state unchanged. Archived items still appear in xtiles_get_project_structure with is_archived: true, which is how to find one again to unarchive it. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| updated | Yes | ||
| view_id | Yes |