Pages & Blog

Custom pages and blog posts are the same content type on Kardow: a blog post is a page flagged as a blog article. These endpoints let another system (or an AI assistant via the MCP connector) manage them programmatically.

Authenticate every request with your API key in the x-api-key header. A valid key can manage its own organization’s content. Create keys under Settings > API in the dashboard.

Content format

Send the body in the content field as HTML (recommended, easiest to produce). It is stored as rich-text and rendered on your live site. You may also send TipTap JSON directly if you already have it. These elements render on the live site:

Element	HTML
Headings	`<h1>` through `<h6>`
Paragraph, line break	`<p>`, `<br>`
Emphasis	`<strong>`, `<em>`, `<s>`, inline `<code>`
Lists	`<ul>` / `<ol>` with `<li>`
Quote	`<blockquote>`
Code block	`<pre><code>...</code></pre>`
Divider	`<hr>`
Link	`<a href="...">`
Image	`<img src="...">`
Table	`<table>` / `<tr>` / `<th>` / `<td>` (colspan/rowspan supported)
Text alignment	any block with `style="text-align:center"` (or right/justify)
Text color	`<span style="color:#2563eb">...</span>`
YouTube	`<div data-youtube-video><iframe src="https://www.youtube.com/embed/VIDEO_ID"></iframe></div>`
Embed (iframe)	`<iframe src="https://..." width="100%" height="600px">`

Wide tables render inside a horizontal scroller on the live site, so real data tables with many columns are fine. Generic iframes cover embeds like Tableau dashboards, maps, calendars, or booking widgets: use the provider’s embed or share URL as the src. Embeds render sandboxed on the live site. Interactive builder blocks (pricing tables, contact/subscribe forms, section templates) are managed in the dashboard editor and are not authored through the API. Any HTML you send outside the list above is cleaned out, so stick to these tags for predictable results. For images, do not hard-link an external URL inside content. Upload it first with the Assets API so it is hosted on your board, then use the returned cdn.kardow.com URL as the cover_image or inside the HTML.

List pages

GET https://api.kardow.com/pages

string

blog_post (blog articles), page (standalone pages), or all (default).

string

Filter by draft, published, or archived.

string

Match against the title.

number

default:"1"

Page number.

number

default:"20"

Records per page, up to 100.

cURL

curl --url "https://api.kardow.com/pages?kind=blog_post&status=published" \
  --header "x-api-key: your-api-key-here"

Each item includes id, title, slug, kind fields (type, is_blog_article), status, the full public url, cover_image (a cdn.kardow.com URL), meta_title, meta_description, author_id, published_at, created_at, and updated_at. The list is metadata only; fetch a single page to get its body.

Get a page

GET https://api.kardow.com/pages/{id}

Returns everything from the list shape plus content (TipTap JSON), content_html (the body rendered as HTML, easiest to read and revise), content_text (plain text), og_image, and custom_fields.

cURL

curl --url "https://api.kardow.com/pages/4d1b6fe8-688f-467c-b233-b5d6a51ce1cb" \
  --header "x-api-key: your-api-key-here"

Create a page or blog post

POST https://api.kardow.com/pages

string

required

Page or article title.

string

Body as HTML (or TipTap JSON). Empty is allowed.

string

default:"page"

blog_post to create a blog article, page for a standalone page.

string

default:"draft"

published to make it live immediately, or draft to keep it hidden.

string

URL slug. Auto-generated from the title (and de-duplicated) if omitted.

string

Cover/hero image URL, ideally a cdn.kardow.com URL from the Assets API. Shown on blog cards.

string

SEO title.

string

SEO description; also used as the blog card summary.

string

Optional author UUID for blog posts.

string

Optional publish date (ISO 8601). Defaults to now when status is published.

cURL

curl --request POST \
  --url "https://api.kardow.com/pages" \
  --header "Content-Type: application/json" \
  --header "x-api-key: your-api-key-here" \
  --data '{
    "title": "5 Remote Hiring Trends for 2026",
    "kind": "blog_post",
    "status": "published",
    "cover_image": "https://cdn.kardow.com/abc123/storage/v1/object/public/org-assets/42/library/cover.png",
    "meta_description": "What we learned about remote hiring this year.",
    "content": "<h2>The shift to async</h2><p>Teams increasingly hire across time zones...</p><ul><li>Point one</li><li>Point two</li></ul>"
  }'

The response returns the full page including its public url.

Update a page

PATCH https://api.kardow.com/pages/{id}

Send only the fields you want to change. Accepts the same fields as create (title, content, status, slug, cover_image, meta_title, meta_description, author_id, published_at). Passing content replaces the body. Setting status to published stamps published_at automatically the first time.

cURL

curl --request PATCH \
  --url "https://api.kardow.com/pages/4d1b6fe8-688f-467c-b233-b5d6a51ce1cb" \
  --header "Content-Type: application/json" \
  --header "x-api-key: your-api-key-here" \
  --data '{ "status": "published" }'

Delete a page

DELETE https://api.kardow.com/pages/{id}

cURL

curl --request DELETE \
  --url "https://api.kardow.com/pages/4d1b6fe8-688f-467c-b233-b5d6a51ce1cb" \
  --header "x-api-key: your-api-key-here"

Getting Started

Analytics

Jobs

Applications

Content

Members

Users

Webhooks

Secrets

CMS

Content format

List pages

Get a page

Create a page or blog post

Update a page

Delete a page

​Content format

​List pages

​Get a page

​Create a page or blog post

​Update a page

​Delete a page

Content format

List pages

Get a page

Create a page or blog post

Update a page

Delete a page