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

# POST /managed-doc/{namespace}/{slug}/version

`POST /managed-doc/{namespace}/{slug}/version`

Create a new api document version

## Path parameters

- `namespace` string, required
- `slug` string, required

## Request body

- object
  - `version` string, required
  - `document` string, required
  - `force` boolean
  - `isCurrent` boolean, required
  - `docsProjectUid` string

## Response `200`

Default Response

- ManagedDocVersion
  - `uid` string, required
  - `createdAt` number, required
  - `version` string, required
  - `upgraded` boolean, required
  - `embedStatus` 'complete' | 'failed', nullable, required
  - `tags` string[], required
  - `tools` object[]
    - `path` string, required
    - `method` 'delete' | 'get' | 'head' | 'options' | 'patch' | 'post' | 'put' | 'trace', required
    - `enabledTools` string[], required
  - `yamlSha` string
  - `jsonSha` string

## Other responses

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

## Changes

> 16 revisions in range; 8 could not be searched.

- **2026-08-07** `8dff1e93bc68` — 1 info
  - api operation id `postmanagedDocNamespaceSlugVersion` removed and replaced with `postManagedDocNamespaceSlugVersion`

[Change history](https://skmtc.dev/scalar/apis/core/changes/managed-doc/:namespace/:slug/version/post.md)

---

[API](https://skmtc.dev/scalar/apis/core.md) · [All operations](https://skmtc.dev/scalar/apis/core/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scalar/core/revisions/2c53f2191a3e/schema)