Overview

Create a shared component version

POST/v1/schemas/{namespace}/{slug}/version
Features

Create a schema version.

Input4
Authorizationheaderrequired
Your API key, sent as Authorization: Bearer YOUR_SCALAR_ACCESS_TOKEN.Sent from your browser straight to the API — never to Docsbook, never stored.
namespacestring · pathrequired
slugstring · pathrequired
versionstring · bodyrequired
documentstring · bodyrequired
Output1
uidstring
Responses
200Default Response
400Bad request
401No auth
403Forbidden
404Not found
422Invalid payload
500Uncaught error
Example input
curl -X POST 'https://access.scalar.com/v1/schemas/{namespace}/{slug}/version' \
  -H 'Authorization: Bearer YOUR_SCALAR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"version":"<version>","document":"<document>"}'
Example output
{
  "uid": "<uid>"
}

Updated

Was this page helpful?