Flowershow

Publish files as a live website on Flowershow and get a shareable URL. Use when the user says "publish this", "put this online", "make this a website", "share this as a page" or "host this". Accepts Markdown (.md, rendered as a styled page with navigation), HTML (.html, served as-is) and supporting files such as CSS, JS, JSON and images: one page or a small site, up to 50 files and 3 MB per call. Name the home page index.md or index.html. Without an account this creates a new site that expires in 7 days and returns a claim link: always show the user the live URL and the claim link exactly as returned, so they can keep the site. To update that site later in the conversation, call publish again with its siteId and claimToken and only the files you changed or added: files you don't send are kept as they are. To remove pages or files, list their paths in delete (files can then be empty). Only when the user explicitly asks to start the site over, set replaceWholeSite to true: the files you send become the whole site and every other file is removed. If that would remove existing files, the call is refused and tells you how many and which; ask the user, then call again with confirmDeleteCount set to that number. For bigger sites, suggest the Flowershow CLI (fl).

{
  "type": "object",
  "properties": {
    "files": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "description": "Relative path, e.g. \"index.html\" or \"img/logo.png\""
          },
          "content": {
            "description": "Text content (UTF-8)",
            "type": "string"
          },
          "contentBase64": {
            "description": "Binary content, base64-encoded (images etc.)",
            "type": "string"
          }
        },
        "required": [
          "path"
        ]
      },
      "description": "Files to add or update. When updating a site, send only the files that changed; other files are kept. Can be empty when only deleting."
    },
    "siteId": {
      "description": "Update this existing site instead of creating a new one",
      "type": "string"
    },
    "claimToken": {
      "description": "The claimToken returned when the anonymous site was created (needed with siteId when not signed in)",
      "type": "string"
    },
    "delete": {
      "description": "Paths of existing files to remove from the site (with siteId), e.g. [\"old-page.md\"]",
      "maxItems": 1000,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "replaceWholeSite": {
      "description": "Set true only when the user asks to start the site over: the files sent become the whole site and all other files are permanently removed. Never use it to update a few pages. Default false.",
      "type": "boolean"
    },
    "confirmDeleteCount": {
      "description": "With replaceWholeSite: the number of existing files the replace will remove, as reported by the refused first call. Set it only after the user has confirmed.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "files"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "liveUrl": {
      "type": "string"
    },
    "siteId": {
      "type": "string"
    },
    "claimUrl": {
      "type": "string"
    },
    "claimToken": {
      "type": "string"
    },
    "expiresAt": {
      "type": "string"
    },
    "message": {
      "type": "string"
    }
  },
  "required": [
    "liveUrl",
    "siteId",
    "message"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}