webhook_only articles

Webhook-only articles are syndicated to a single consumer platform (e.g. misar.io/blogs, assisters.io/blogs) and are never publicly listed on misar.blog. Use ?webhook_only=true to fetch only those, or ?webhook_only=false to exclude them. Each item includes a webhook_only boolean.

List Articles

GET/articles

Returns a paginated list of the authenticated creator's published articles.

Query parameters

limitintegerquerydefault: 20

Results per page (max 100).

statusstringquerydefault: published

draft, published, scheduled, archived, or flagged.

webhook_onlybooleanquery

true returns only webhook-only articles; false excludes them.

visibilitystringquery

Filter by exact visibility, e.g. public, webhook_only.

Response fields

articlesArray<Article>

The list of articles. Each item includes id, slug, title, excerpt, status, tags, published_at, created_at, view_count, is_premium, price_cents, visibility, webhook_only, and url.

totalinteger

Number of articles returned.

200 — OK

{
  "articles": [
    {
      "id": "uuid",
      "slug": "building-ai-apps-with-next-js",
      "title": "Building AI Apps with Next.js",
      "excerpt": "A practical guide to integrating AI into your Next.js applications.",
      "status": "published",
      "tags": ["nextjs", "ai", "tutorial"],
      "published_at": "2026-04-15T09:00:00Z",
      "created_at": "2026-04-15T08:55:00Z",
      "view_count": 4210,
      "is_premium": false,
      "price_cents": 0,
      "visibility": "public",
      "webhook_only": false,
      "url": "https://www.misar.blog/@johndoe/articles/building-ai-apps-with-next-js"
    }
  ],
  "total": 37
}

Publish an Article

POST/articles

Publishes a new article or schedules it for future publication.

Request body

titlestringbodyrequired

Article title (max 250 chars).

body_markdownstringbodyrequired

Markdown body.

tagsstring[]body

Array of tag slugs (max 10; each truncated to 50 chars).

cover_image_urlstringbody

Cover image URL. Must be a valid https URL.

visibilitystringbodydefault: public

One of public, subscribers, paid, private, or webhook_only.

schedule_atstringbody

ISO 8601 datetime to schedule publication; omit to publish immediately.

Response fields

idstring

Unique identifier of the article.

slugstring

The article's URL slug (auto-generated from the title, de-duplicated per author).

titlestring

The article title.

statusstring

published or scheduled.

urlstring

Public URL of the article.

editor_urlstring

URL to open the article in the web editor.

published_atstring

ISO 8601 publication time (null when scheduled).

created_atstring

ISO 8601 creation time.

Request

{
  "title": "Building AI Apps with Next.js",
  "body_markdown": "## Introduction\n\nThis guide covers...",
  "tags": ["nextjs", "ai", "tutorial"],
  "cover_image_url": "https://...",
  "visibility": "public",
  "schedule_at": null
}

201 — Created

{
  "id": "uuid",
  "slug": "building-ai-apps-with-next-js",
  "title": "Building AI Apps with Next.js",
  "status": "published",
  "url": "https://www.misar.blog/@johndoe/articles/building-ai-apps-with-next-js",
  "editor_url": "https://www.misar.blog/editor/uuid",
  "published_at": "2026-04-15T09:00:00Z",
  "created_at": "2026-04-15T09:00:00Z"
}

Get a Single Article

GET/articles/{slug}

Returns full article data by slug.

Path parameters

slugstringpathrequired

Slug of the article to retrieve.

Response fields

The full article is returned as a flat object: id, slug, title, excerpt, content_markdown, content_html, tags, status, visibility, is_premium, price_cents, published_at, created_at, updated_at, view_count, read_count, featured_image_url, webhook_only, url, and editor_url.

200 — OK

{
  "id": "uuid",
  "slug": "building-ai-apps-with-next-js",
  "title": "Building AI Apps with Next.js",
  "content_markdown": "## Introduction\n\nThis guide covers...",
  "status": "published",
  "visibility": "public",
  "webhook_only": false,
  "url": "https://www.misar.blog/@johndoe/articles/building-ai-apps-with-next-js",
  "editor_url": "https://www.misar.blog/editor/uuid"
}

Update or Publish a Draft

PATCH/articles/{slug}

Updates a draft's title, body_markdown, or tags, and can publish it in the same call by setting publish: true. Any field you omit is left unchanged.

Path parameters

slugstringpathrequired

Slug (or UUID) of the article to update.

Request body

titlestringbody

New title.

body_markdownstringbody

New Markdown body.

tagsstring[]body

Replacement tag list.

publishbooleanbodydefault: false

Set to true to publish the draft as part of this update.

Response fields

Returns the full Article object with its new status.

Request

{
  "title": "Building AI Apps with Next.js (2026 edition)",
  "tags": ["nextjs", "ai", "tutorial", "2026"],
  "publish": true
}

200 — OK

{
  "id": "uuid",
  "slug": "building-ai-apps-with-next-js",
  "title": "Building AI Apps with Next.js (2026 edition)",
  "status": "published",
  "url": "https://www.misar.blog/@johndoe/articles/building-ai-apps-with-next-js",
  "editor_url": "https://www.misar.blog/editor/uuid",
  "published_at": "2026-08-04T09:00:00Z",
  "created_at": "2026-08-01T08:55:00Z"
}

Status codes

400 — Missing or invalid title / body_markdown (on create)
401 — Invalid or missing API key
404 — Article not found or belongs to another user
422 — Content quality checks failed (enforced for managed SEO authors only)

Articles

List Articles

Publish an Article

Get a Single Article

Update or Publish a Draft

Status codes

On this page