---
title: "Create a new document"
method: POST
path: "/documents/create"
tags: ["documents"]
---

# Create a new document

`POST /documents/create`

## Request body

- DocumentCreateRequest
  - `type` string, required
  - `lang` string, required
  - `title` string, required
  - `slug` string
  - `content` string, required
  - `frontmatter` GenericObject

## Response `200`

Created document

- DocumentDetail
  - `id` string
  - `type` string
  - `lang` string
  - `title` string
  - `slug` string
  - `url` string
  - `layout` string
  - `summary` string
  - `date` string, date-time
  - `author` string
  - `last_editor` string
  - `taxonomies` GenericObject
  - `html_body` string
  - `raw_body` string
  - `fields` GenericObject
  - `params` GenericObject
  - `created_at` string, date-time
  - `updated_at` string, date-time

---

[API](https://skmtc.dev/sphireinc/apis/foundry-api.md) · [All operations](https://skmtc.dev/sphireinc/apis/foundry-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sphireinc/foundry-api/revisions/3696c13096d0/schema)