Home

Import a dropped or pasted file as an artifact

Changed on

One-step import from the Studio Home. Publishes a document (HTML, CSV, Markdown, JSON, text, PDF, Word .docx/.doc/.odt, or a spreadsheet .xlsx/.xls/.ods), pasted HTML, or a Claude / ChatGPT / Gemini share link (best-effort fetch) as a private artifact in the current workspace and folder. Word files become Markdown and spreadsheets one CSV per sheet. Slide decks (.pptx/.ppt/.odp) become a PDF on instances with the optional LibreOffice converter (SLIDES_CONVERTER); without it they answer 422 CONVERT_UNAVAILABLE. All of these keep the original file for download and must be sent base64-encoded. Images, video and other files belong in Assets (/v1/assets). Inside a workspace the caller must be an internal member. Counts toward the daily publish limit and the storage cap. Agent (sot_) tokens are refused.

post/v1/home/import

Request

  • Base URL
    https://shareout.site
  • URL
    https://shareout.site/v1/home/import
  • Auth
    HTTP bearer

Query parameters

workspacestring

Workspace id (ignored on a workspace subdomain, which pins it).

Request body

namestring

File name; its extension picks the artifact type.

contentstring
encoding'utf8' | 'base64'
htmlstring

Pasted HTML source.

urlstring

A Claude, ChatGPT or Gemini share link.

folderstring

Folder id to publish into.

lang'en' | 'es'

Response

Published

okboolean
artifactIdstring
slugstring
namestring
typestring

Changes