---
title: "Import a dropped or pasted file as an artifact"
method: POST
path: "/v1/home/import"
tags: ["Home"]
---

# Import a dropped or pasted file as an artifact

`POST /v1/home/import`

## Request

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

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.

## Query parameters

- `workspace` string

## Request body

- object
  - `name` string: File name; its extension picks the artifact type.
  - `content` string
  - `encoding` 'utf8' | 'base64'
  - `html` string: Pasted HTML source.
  - `url` string: A Claude, ChatGPT or Gemini share link.
  - `folder` string: Folder id to publish into.
  - `lang` 'en' | 'es'

## Response `200`

Published

- object
  - `ok` boolean
  - `artifactId` string
  - `slug` string
  - `name` string
  - `type` string

## Other responses

- `400`: Invalid request
- `401`: Authentication required
- `403`: Access denied
- `404`: Folder not found
- `413`: File too large, spreadsheet too large to convert, or storage limit reached
- `415`: File type belongs in Assets
- `422`: Share link could not be read (login wall or JS-rendered), or an Office file or slide deck could not be converted (`CONVERT_FAILED`, `CONVERT_TIMEOUT`, `CONVERT_UNAVAILABLE`)
- `429`: Daily publish limit reached

## Changes

- **2026-10-13** `436160466407`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shareout/apis/shareout-rest-api/changes/v1/home/import/post.md)

---

[API](https://skmtc.dev/shareout/apis/shareout-rest-api.md) - [All operations](https://skmtc.dev/shareout/apis/shareout-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shareout/apis/shareout-rest-api/revisions/1e3f7fd34f6d?raw)