Skip to content

Pages

All paths below are relative to https://seo.pulpsense.com/api/website-publishing/v1.

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

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.

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.

Use the documented FAQ and medical schema fields. Leaving these fields out preserves them.

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.

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.