---
title: "POST /api/v1/admin/blogs"
method: POST
path: "/api/v1/admin/blogs"
tags: ["platformAdmin"]
---

# POST /api/v1/admin/blogs

`POST /api/v1/admin/blogs`

## Request

- Base URL: `https://api.clerkchat.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.clerkchat.co/api/v1/admin/blogs`
- Auth: none required

## Request body

- object
  - `title` string, required
  - `articleType` 'alternative-vs' | 'use-case' | 'how-to' | 'listicle' | 'glossary-definition' | 'integration' | 'benchmark-data', nullable
  - `secondaryKeywords` string[], nullable
  - `idealCustomerProfile` string, nullable
  - `targetWordCount` integer, nullable
  - `internalLinks` string[], nullable
  - `preferredExternalLinks` string[], nullable
  - `contentBlocks` string[], nullable
  - `additionalInstructions` string, nullable
  - `imageStyle` 'abstract' | 'nature' | 'custom', nullable
  - `imagePrompt` string, nullable
  - `featuredImage` union
    - object
      - `type` 'ai', required
      - `style` 'abstract' | 'nature' | 'custom', required
      - `prompt` string, nullable
    - object
      - `type` 'uploaded', required
      - `mediaId` integer, required
    - object
      - `type` 'pexels', required
      - `photoId` integer, required
  - `socialPlatforms` string[], nullable

## Response `200`

AdminBlogGeneration

- AdminBlogGenerationEncoded
  - `id` string, required
  - `title` string, required
  - `status` 'queued' | 'running' | 'complete' | 'errored' | 'terminated', required
  - `createdAt` union, required
    - number
    - 'Infinity' | '-Infinity' | 'NaN'
  - `updatedAt` union, required
    - number
    - 'Infinity' | '-Infinity' | 'NaN'
  - `output` unknown
  - `error` unknown

## Other responses

- `400`: BadRequest
- `401`: Unauthorized
- `403`: Forbidden
- `503`: PersistenceUnavailable

---

[API](https://skmtc.dev/clerkchat/apis/clerk-chat-api.md) · [All operations](https://skmtc.dev/clerkchat/apis/clerk-chat-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clerkchat/apis/clerk-chat-api/revisions/cc318e39e1d0?raw)