Pages
All paths below are relative to
https://seo.pulpsense.com/api/website-publishing/v1.
Endpoints
Section titled “Endpoints”| Method | Path | Result |
|---|---|---|
GET |
/pages |
Page inventory and current/live revision numbers |
GET |
/pages/:id |
Current complete page and revision metadata |
GET |
/pages/:id?revision=2 |
A retained revision |
GET |
/pages/:id/history |
Revision authors and timestamps |
POST |
/pages |
New draft page; returns 201 |
PATCH |
/pages/:id |
New revision of an existing page |
Update an existing page
Section titled “Update an existing page”Send the current revision as expectedRevision. A stale revision returns 409.
The patch supports metadata, sections, faqs and schema.
{ "expectedRevision": 3, "patch": { "metadata": { "title": "Your updated page title", "description": "Your complete updated search description." } }}Omitted content remains intact. URL changes and deletion are not supported.
Body content
Section titled “Body content”The complete page has an ordered sections array. Read the current page to find
the index and existing content-slot names you want to edit. This example replaces
the body prose slot of section 1:
{ "expectedRevision": 3, "patch": { "sections": [ { "index": 1, "prose": { "body": [ { "tag": "p", "attributes": {}, "children": [ { "text": "Read our " }, { "tag": "a", "attributes": { "href": "/contact-us/" }, "children": [{ "text": "contact information" }] }, { "text": " before your visit." } ] } ] } } ] }}Safe prose supports headings, paragraphs, links, lists, images, quotations, details and tables. Use structured nodes, rather than raw HTML. Scripts, new iframes, event handlers, style attributes and executable URLs are rejected.
copy updates existing named plain-text slots. media updates existing image
slots with {src,alt}. Replacing an image removes stale responsive URLs and
dimensions from the previous image; changing only its alt text retains them.
Layout components and arbitrary new slot names cannot be changed through this API.
FAQs and structured data
Section titled “FAQs and structured data”Use the documented FAQ and medical schema fields. Leaving these fields out preserves them.
Create a page
Section titled “Create a page”Choose an existing editorial/service page as templatePageId. The new page
clones its supported hero, editorial body, FAQ and closing structure, with your
own content.
{ "templatePageId": "11111111-1111-4111-8111-111111111111", "content": { "route": "new-service", "title": "Your new service", "description": "Your complete page description.", "body": [ { "tag": "p", "attributes": {}, "children": [{ "text": "Your complete page content." }] } ] }}Use a real template UUID from your page inventory. Choose a page with the
editorial/FAQ structure you need, rather than a gallery or article. The route
must be unused and contain lowercase words or numbers separated by hyphens,
with optional /-separated segments and no leading or trailing slash.
The new page starts as a draft revision. It becomes available at its route only after a successful publication. New navigation entries and homepage changes are managed by PulpSense.
Restore older content
Section titled “Restore older content”Read the desired retained revision, then make a new patch against the current revision. Preview and publish the restored content as a new revision. History remains available; restoring does not delete later records.