Base URL

Authentication

All API requests require authentication via Bearer token:

Get your API key from Settings → API in your Wrodium dashboard.

Endpoints

List CMS Articles

Retrieve articles from your connected CMS.

Path Parameters

Query Parameters

Response

{
  "articles": [
    {
      "id": "123",
      "cms_type": "wordpress",
      "title": "How to Optimize for AI Search",
      "excerpt": "Learn the key strategies for appearing in AI-generated answers...",
      "published_at": "2024-01-15T10:30:00Z",
      "word_count": 1542,
      "status": "published",
      "url": "https://yourblog.com/optimize-ai-search",
      "raw": {}
    }
  ],
  "total": 45,
  "has_more": true
}

Response Fields

Example Request

curl -X GET "https://api.wrodium.com/v1/cms/articles/mybrand?limit=10" \
  -H "Authorization: Bearer wrod_xxxxxxxxxxxx"

Errors

Update CMS Article

Push optimized content back to your CMS.

Request Body

{
  "brand_url": "mybrand",
  "article_id": "123",
  "title": "Updated: How to Optimize for AI Search",
  "content_html": "<h1>Introduction</h1><p>AI search is changing...</p>",
  "excerpt": "Updated summary of AI search optimization strategies",
  "slug": "optimize-ai-search-2024",
  "publish": true
}

Request Fields

Response

Returns the updated ArticleSummary object:

{
  "id": "123",
  "cms_type": "wordpress",
  "title": "Updated: How to Optimize for AI Search",
  "excerpt": "Updated summary of AI search optimization strategies",
  "published_at": "2024-01-15T10:30:00Z",
  "word_count": 1687,
  "status": "published",
  "url": "https://yourblog.com/optimize-ai-search-2024",
  "raw": {}
}

Example Request

curl -X POST "https://api.wrodium.com/v1/cms/update-article" \
  -H "Authorization: Bearer wrod_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "brand_url": "mybrand",
    "article_id": "123",
    "content_html": "<h1>Introduction</h1><p>AI search is changing...</p>",
    "publish": true
  }'

Errors

Get CMS Configuration

Retrieve your CMS connection settings (without sensitive credentials).

Response

{
  "brand_url": "mybrand",
  "provider": "wordpress",
  "connected": true,
  "last_sync": "2024-01-15T14:30:00Z",
  "article_count": 45
}

Test CMS Connection

Verify your CMS connection is working.

Response

{
  "success": true,
  "provider": "wordpress",
  "message": "Successfully connected to WordPress",
  "article_count": 45
}

Data Models

ArticleSummary

Normalized article representation across all CMS providers.

interface ArticleSummary {
  id: string;              // Unique ID from CMS
  cms_type: string;        // Provider name
  title: string;           // Plain text title
  excerpt: string;         // Plain text excerpt
  published_at: string;    // ISO 8601 datetime
  word_count: number;      // Approximate words
  status: string;          // published | draft | archived
  url: string | null;      // Public URL
  raw: object;             // Original CMS response
}

ArticleUpdateInput

Input for updating an article.

interface ArticleUpdateInput {
  title?: string;          // New title (optional)
  content_html: string;    // HTML content (required)
  excerpt?: string;        // New excerpt (optional)
  slug?: string;           // New URL slug (optional)
  publish: boolean;        // Publish after update (default: true)
}

UpdateArticleRequest

Full request body for the update endpoint.

interface UpdateArticleRequest {
  brand_url: string;       // Brand identifier
  article_id: string;      // CMS article ID
  title?: string;
  content_html: string;
  excerpt?: string;
  slug?: string;
  publish: boolean;
}

CMS Provider Specifics

WordPress

• Uses REST API v2

• Authentication: Application Passwords

• Content field: content.rendered → content

• Supports custom post types via configuration

Webflow

• Uses Data API v2

• Requires field ID mapping in configuration

• Updates go to /items/{id}/live endpoint

• Supports localization

Contentful

• Uses Content Management API (CMA)

• Requires optimistic locking (X-Contentful-Version)

• All fields are locale-specific

• Updates create new versions (not auto-published)

Ghost

• Uses Admin API with JWT authentication

• Requires updated_at for collision detection

• Supports HTML and Lexical content formats

Custom Webhook

• You define pull and update endpoints

• Must return normalized article format

• Supports custom authentication headers

Rate Limits

Rate limit headers are included in responses:

Error Responses

All errors follow this format:

{
  "detail": "Error message here",
  "code": "ERROR_CODE",
  "errors": []
}

Common Error Codes

SDKs

Python

from wrodium import WrodiumClient

client = WrodiumClient(api_key="wrod_xxx")

# List articles
articles = client.cms.list_articles("mybrand", limit=20)

# Update article
result = client.cms.update_article(
    brand_url="mybrand",
    article_id="123",
    content_html="<p>Updated content</p>",
)

JavaScript/TypeScript

import { Wrodium } from '@wrodium/sdk';

const client = new Wrodium({ apiKey: 'wrod_xxx' });

// List articles
const articles = await client.cms.listArticles('mybrand', { limit: 20 });

// Update article
const result = await client.cms.updateArticle({
  brandUrl: 'mybrand',
  articleId: '123',
  contentHtml: '<p>Updated content</p>',
});

Webhooks

Wrodium can send webhooks when CMS operations complete.

Events

Payload

{
  "event": "cms.article.updated",
  "timestamp": "2024-01-15T14:30:00Z",
  "data": {
    "brand_url": "mybrand",
    "article_id": "123",
    "cms_type": "wordpress",
    "status": "success"
  }
}

Configure webhooks in Settings → Webhooks.