Migrate to V2

One address: POST creates, PUT updates, GET reads. The article URL is its identifier.

What changes

Saving

After saving, return {"url":"https://site.example/blog/article"} with the article’s real public address.

Editing

Blogent sends PUT with the article’s url and updated content. Find that page by its URL and update it.

Reading

GET by url returns {"article":{...}} with the saved fields.

HTML classes

Style .blgn-article, .blgn-tldr, .blgn-media, .blgn-image, .blgn-video and .blgn-shortcode in your article template.

Authors (optional)

Implement GET ?authors=1 to return existing site IDs and names. Blogent imports them and sends only author_id when creating an article.

Update your handler

1. Return the public URL after creation.

   Keep your POST creation code and article fields. After saving, return the actual public address.

2. Add PUT for updates.

   Find the page by url and replace the supplied fields in each language. No alias or urls are sent for replacement. Preserve URL, slugs, translations and original publication data. Save modified_at and show the updated date on the page and in dateModified. Unknown URL returns 500 with an error describing the cause.

3. Return the saved article on GET.

   Return only {"article":{...}} with all saved languages, their aliases, HTML, preview, SEO fields, TOC and reading time. GET, POST and PUT use the same secret header.

4. Run the connection test.

   Create, update and read one article with the test below. Compare all article fields and every language. Check the visible updated date and dateModified.

Update request: PUT with url

Send the article’s existing public address in url and its complete updated content below. The original cover, author, publication date, category and product parameters remain in the website’s storage.

{
    "url": "https://your-site.example/blog/article-en",
    "modified_at": "2026-10-15 09:00:00",
    "article": {
        "en": {
            "title": "How to plan a useful blog article",
            "preview": "<p>A practical guide to planning an article.</p>",
            "meta_title": "Plan a useful blog article",
            "meta_description": "Updated advice on article structure, examples and review.",
            "reading_time_minutes": 1,
            "toc": [
                {
                    "id": "main-section",
                    "title": "Plan the structure",
                    "level": 2
                },
                {
                    "id": "nested-point",
                    "title": "Choose useful examples",
                    "level": 3
                }
            ],
            "text": "<div class=\"blgn-article\"><p class=\"blgn-tldr\"><strong>TLDR:</strong> Keep a clear structure and update the advice when your process changes.</p><h2 id=\"main-section\">Plan the structure</h2><p>Start with the reader’s question and a clear answer.</p><h3 id=\"nested-point\">Choose useful examples</h3><p>Use examples from your actual workflow.</p><img src=\"https://your-site.example/images/article-example.webp\" alt=\"Example article outline\" loading=\"lazy\"><p><a href=\"https://your-site.example/guides\" rel=\"noopener\" target=\"_blank\">More guides</a></p></div>"
        }
    }
}

Done: POST creates a page, PUT updates it, GET reads it. The public URL remains unchanged.