Skip to main content
Publishing copies a page’s current draft to its published version (what visitors see). See publishing & access for the model.

Publish a page

POST /api/v1/pages//publish Copies the current draft to the live version. Use this after updating a page’s HTML to push the changes live.
curl -X POST https://useshareable.com/api/v1/pages/PAGE_ID/publish \
  -H "Authorization: Bearer sm_your_key"
Returns:
{
  "data": {
    "id": "…",
    "url": "https://useshareable.com/p/…",
    "is_published": true,
    "has_unpublished_changes": false
  }
}

Unpublish a page

DELETE /api/v1/pages//publish Takes the page offline — the URL stops serving content (visitors get a “not published” notice) and the draft is preserved. Re-publish anytime.
curl -X DELETE https://useshareable.com/api/v1/pages/PAGE_ID/publish \
  -H "Authorization: Bearer sm_your_key"
Returns:
{ "data": { "is_published": false } }