---
title: "Create a blank document or one from a template"
method: POST
path: "/v1/home/new"
tags: ["Home"]
---

# Create a blank document or one from a template

`POST /v1/home/new`

## Request

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

The Studio "New" menu's no-AI path. Creates a private HTML document owned by the caller — blank or from a simple template (report, meeting notes, proposal) — and returns where to open it. Inside a workspace (subdomain or `workspace` query) 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
  - `template` 'blank' | 'report' | 'meeting' | 'proposal'
  - `lang` 'en' | 'es': Language of the document's title and headings.

## Response `200`

Created

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

## Other responses

- `400`: Invalid request
- `401`: Authentication required
- `403`: Access denied
- `413`: Storage limit reached
- `429`: Daily publish limit reached

## Changes

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

[Operation history](https://skmtc.dev/shareout/apis/shareout-rest-api/changes/v1/home/new/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)