v50

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-07-068428533.0 MB
API Product Documentation

Create API Product Document

Creates a document for an API product.

post/v2/api-products/{apiProductId}/documents

Request body

parent_document_idstring uuid nullable

parent document id

slugstring required

document slug. must be unique accross documents belonging to an api product

status'published' | 'unpublished' required
titlestring required

document title

contentstring nullable

Can be markdown string content or base64 encoded string

metadataobject

metadata of the document

Example request

{
  "parent_document_id": "dd4e1b98-3629-4dd3-acc0-759a726ffee2",
  "slug": "path-for-seo",
  "title": "How to create a document in Konnect DocumentHub",
  "content": "## My Markdown",
  "metadata": {
    "author": "John Doe"
  }
}

Response

API product document

idstring uuid required
parent_document_idstring uuid nullable required
titlestring required
slugstring required
status'unpublished' | 'published' required
metadataobject required
contentstring required

The unencoded markdown string of the api product document.

created_atstring date-time required

An ISO-8601 timestamp representation of entity creation date.

updated_atstring date-time required

An ISO-8601 timestamp representation of entity update date.

Example response

{
  "created_at": "2022-11-04T20:10:06.927Z",
  "updated_at": "2022-11-04T20:10:06.927Z"
}