POST
/
products
/
{product_id}
/
docs
Create a new tutorial page for this API Product
curl --request POST \
  --url http://localhost:3001/portal-api/products/{product_id}/docs \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "Content": "# Title\r\n## Subtitle\r\nContent goes here",
  "MarkdownEnabled": true,
  "Status": "published",
  "Title": "Get started this API Product",
  "Lede": "<string>",
  "Path": "<string>",
  "Categories": [
    "<string>"
  ],
  "Tags": [
    "<string>"
  ],
  "MarkdownContent": "<string>",
  "PreviewContent": "<string>"
}'
{
  "Content": "# Title\r\n## Subtitle\r\nContent goes here",
  "MarkdownEnabled": true,
  "Status": "published",
  "Title": "Get started this API Product",
  "Lede": "<string>",
  "Path": "<string>",
  "Categories": [
    "<string>"
  ],
  "Tags": [
    "<string>"
  ],
  "MarkdownContent": "<string>",
  "PreviewContent": "<string>"
}

Authorizations

​
Authorization
string
header
required

Path Parameters

​
product_id
integer
required

UID of an API Product

Example:

1

Body

application/json
​
Content
string

Full content of the post

Example:

"# Title\r\n## Subtitle\r\nContent goes here"

​
MarkdownEnabled
boolean

Whether Markdown is enabled for this post

Example:

true

​
Status
enum<string>

Status of the post (e.g., draft, published)

Available options:
published,
draft,
review
Example:

"published"

​
Title
string

Title of the post

Example:

"Get started this API Product"

​
Lede
string

Short summary or lead paragraph of the post

​
Path
string

URL path for the post

​
Categories
string[]

List of category IDs to associate with the post

​
Tags
string[]

List of tag IDs to associate with the post

​
MarkdownContent
string

Content of the post in Markdown format, if Markdown is enabled

​
PreviewContent
string

Preview content of the post

Response

OK

​
Content
string

Full content of the post

Example:

"# Title\r\n## Subtitle\r\nContent goes here"

​
MarkdownEnabled
boolean

Whether Markdown is enabled for this post

Example:

true

​
Status
enum<string>

Status of the post (e.g., draft, published)

Available options:
published,
draft,
review
Example:

"published"

​
Title
string

Title of the post

Example:

"Get started this API Product"

​
Lede
string

Short summary or lead paragraph of the post

​
Path
string

URL path for the post

​
Categories
string[]

List of category IDs to associate with the post

​
Tags
string[]

List of tag IDs to associate with the post

​
MarkdownContent
string

Content of the post in Markdown format, if Markdown is enabled

​
PreviewContent
string

Preview content of the post