suggest_link

io.github.lavanry/docfarm · Verify this server

The share link a NEW doc would get, before you publish it. People want to see and name their link before it exists, because changing it later breaks the copies already sent. So before host_html_content or finalize_upload creates a new doc, call this with the name you will publish under, show the person the full link, and ask whether they want a different ending, the part after the last slash. Pass the ending they settle on to the publish call as `slug`. Skip the question when they already chose the link or asked you to just publish. To check an ending they suggest, pass it as `slug` here. The answer says whether it is free and offers one that is if not. A name that matches one of their docs returns that doc's current link instead, because publishing under it updates that doc and keeps its link.