# sites

> Reference for the sites tool of Geenius MVP: websites, designs, the library, publishing, domains and versions, with every action.

Source: https://mvp.geenius.io/docs/reference/sites/

Websites in one workspace. Bring your own AI: it researches the business from official sources and writes the content; Geenius MVP validates, keeps versions, spreads designs and renders. Any member seat reads and edits a site; publishing, domains, rollback and removal need an admin or owner.

Call it as `geenius_mvp(tool: "sites", action: "<action>", args: {...})` through Geenius OS.

## Actions

| Action | What it does |
|---|---|
| `address_check` | Is a geenius.site address free? |
| `address_set` | Move the site to another free address. |
| `bots` | What the bot gate did on this site, per day. |
| `brief_read` | The site's brief. |
| `brief_write` | Write the site's brief. |
| `comment_add` | A comment on one component. |
| `comment_reopen` | Reopen a thread. |
| `comment_reply` | Reply in a thread. |
| `comment_resolve` | Resolve a thread. |
| `comments_list` | The preview's comment threads, newest first. |
| `contact_form` | Make the site's contact form and its section (depends on Geenius OS Forms). |
| `content_from_profile` | Refresh a site from a company profile (depends on Geenius OS Profiles). |
| `content_missing` | What is still untranslated or empty. |
| `content_read` | The content document and its revision. |
| `content_write` | Write the site's content: whole, as a patch, or the demo's. |
| `create` | A new site, with its address and several designs far apart. |
| `css_set` | Scoped CSS for one component (the escape hatch). |
| `deployment_pin` | Pin a publish for rollback, or unpin it. |
| `deployments` | The kept publishes, domains and repository. |
| `design_read` | The site's design and its label. |
| `design_set` | Set the site's design: one axis or a whole design. |
| `designs_decide` | Approve, decline or archive a design proposal. |
| `designs_library` | The designs you can use (the system library and your own). |
| `designs_list_proposals` | The design proposals. |
| `designs_propose` | Propose design compositions into your person's queue. |
| `domain_connect` | Connect the person's own domain. |
| `domain_guide` | The DNS guide for a hostname, without connecting it. |
| `domain_remove` | Disconnect a domain from the site. |
| `domain_status` | Checks a connected domain's DNS and certificate. |
| `eject` | Hand the site over to its GitHub repository. |
| `entity_list` | Compact rows of one of the site's lists. |
| `entity_remove` | Remove one entry of a list. |
| `entity_write` | Write entries of one of the site's lists. |
| `favourite_set` | Star or unstar a library entry. |
| `favourites` | Your starred library entries and the shared ones. |
| `feature_set` | Set the site's features (map, booking, forms and more). |
| `hosting` | The hosts and what is switched on here. |
| `library_search` | Search the design library. |
| `list` | The workspace's sites. |
| `media_credits` | The credits of the site's photographs. |
| `media_pick` | Put a media_search result into a media slot. |
| `media_remove` | Empty a media slot. |
| `media_search` | Stock photographs for the site (depends on a configured photo provider). |
| `media_set` | Set a media slot (a picture or video, with its credit). |
| `media_use_file` | Put a picture from Files into a media slot (depends on Geenius OS Files). |
| `palette_check` | Check a palette's ramps and contrast, without saving. |
| `palette_create` | A palette of your own. |
| `palette_remove` | Delete a palette of your own. |
| `palette_update` | Change a palette of your own. |
| `palettes` | Your own palettes and shared ones. |
| `post_status` | Publish or unpublish posts. |
| `preset_apply` | Put a preset's design on a site. |
| `preset_remove` | Delete a preset. |
| `preset_save` | Save a design as a preset. |
| `preset_update` | Change a preset. |
| `presets` | Your design presets and the workspace's shared ones. |
| `preview` | The site's preview link and its check. |
| `preview_image` | Pictures of the site (PNG). |
| `preview_rotate` | A new preview link; the old one stops. |
| `publish` | Publish: the site goes live on its own address. |
| `read` | One site in full, and what is wrong or missing. |
| `remove` | Delete the site (its maker or an owner or admin). |
| `repo_connect` | Connect a GitHub repository to the site. |
| `repo_disconnect` | Disconnect the site's repository. |
| `repo_status` | The site's repository and its publish commits. |
| `rollback` | Put a kept publish back (default: the one before). |
| `section_add` | Add a section to a page. |
| `section_move` | Move a section on a page. |
| `section_remove` | Remove a section from a page. |
| `structure_read` | The site's structure (pages, sections, footer). |
| `structure_write` | Write the site's structure (pages and sections). |
| `type_set` | Change a website's type. |
| `types` | What each site type starts with. |
| `unpublish` | Take the site offline (versions stay). |
| `update` | Rename a site or change its languages. |
| `variants_choose` | Apply one design of the latest draw. |
| `variants_generate` | Draw designs as far apart as the library allows (ten by default). |
| `variants_read` | The latest draw of designs. |
| `version_restore` | Copy a version back onto the draft. |
| `version_save` | Freeze the draft as a version. |
| `versions` | The site's saved versions. |

> [!TIP]
> Ask for the exact arguments of any action with `action: "help", of: "address_check"`. The server answers from its own definitions, so that answer is always current.

> [!NOTE]
> create answers the site's address and several designs far apart, each with a preview link that needs no sign-in. Publishing, rollback, domain actions and repository actions need an admin or owner seat, and a refusal names the role it needs.

