---
title: "POST /managed-doc/{namespace}"
method: POST
path: "/managed-doc/{namespace}"
tags: ["api-docs"]
---

# POST /managed-doc/{namespace}

`POST /managed-doc/{namespace}`

Creates a new api document for the namespace

## Path parameters

- `namespace` string, required

## Request body

- object
  - `title` string, required
  - `description` string
  - `version` string, required
  - `document` string, required
  - `slug` string, required
  - `ruleset` string
  - `isPrivate` boolean
  - `docsProjectUid` string

## Response `200`

Default Response

- object
  - `uid` string, required
  - `versionUid` string, required
  - `title` string, required
  - `jsonSha` string, required
  - `yamlSha` string, required
  - `versionSha` string, required

## Other responses

- `400` — Bad request
- `401` — No auth
- `403` — Forbidden
- `404` — Not found
- `422` — Invalid payload
- `500` — Uncaught error

---

[API](https://skmtc.net/scalar/apis/core.md) · [All operations](https://skmtc.net/scalar/apis/core/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalar/core/versions/f2eb95a82c72/schema)