Skip to main content
PUT
/
api
/
v1
/
pages
/
:id.json
Update Page
curl --request PUT \
  --url https://api.launchmystore.io/api/v1/pages/:id.json \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "handle": "<string>",
  "body_html": "<string>",
  "author": "<string>",
  "published": true,
  "published_at": "<string>",
  "template_suffix": "<string>",
  "seo": {},
  "metafields": [
    {}
  ]
}
'
{
  "success": true,
  "data": {}
}

Documentation Index

Fetch the complete documentation index at: https://docs.launchmystore.io/llms.txt

Use this file to discover all available pages before exploring further.

Update Page

Updates an existing page. Only provided fields will be updated.

Request

curl -X PUT "https://api.launchmystore.io/api/v1/pages/page_abc123.json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "About Our Company",
    "body_html": "<h2>Our Updated Story</h2><p>We have grown significantly...</p>"
  }'

Path Parameters

id
string
required
The unique page ID to update

Body Parameters

All parameters are optional. Only provided fields will be updated.
title
string
The page title
handle
string
URL-safe handle
body_html
string
Page content (HTML)
author
string
Author name
published
boolean
Whether the page is published
published_at
string
Publication date (ISO 8601)
template_suffix
string
Custom template suffix (set to null to remove)
seo
object
SEO metadata
metafields
array
Metafields to add or update

Response

success
boolean
Whether the request succeeded
data
object
The updated page object

Example Response

{
  "success": true,
  "data": {
    "id": "page_abc123",
    "title": "About Our Company",
    "handle": "about-us",
    "body_html": "<h2>Our Updated Story</h2><p>We have grown significantly...</p>",
    "author": "Store Admin",
    "published": true,
    "published_at": "2024-01-01T10:00:00Z",
    "template_suffix": null,
    "seo": {
      "title": "About Us | MyStore",
      "description": "Learn about our story, mission, and commitment to quality."
    },
    "created_at": "2024-01-01T10:00:00Z",
    "updated_at": "2024-03-20T15:30:00Z"
  }
}

Notes

  • Changing the handle will break existing links to the page
  • Setting published: false will unpublish the page immediately
  • Navigation menu links may need to be updated if the handle changes

Error Codes

CodeDescription
UNAUTHORIZEDInvalid or missing access token
FORBIDDENApp doesn’t have write_content scope
NOT_FOUNDPage with the specified ID does not exist
VALIDATION_ERRORInvalid request body (see error details)
DUPLICATE_HANDLEA page with this handle already exists