Skip to content
Elara One docs
Pages

Save a draft

PUT
/v1/merchant/pages/{handle}/draft

Authorization

tenantKeybearerAuth
headerX-Tenant-Key<token>

The public store key (pk_live_…). Required on every call.

headerAuthorizationBearer <token>

A customer token from POST /v1/auth/login, or a merchant API key, on routes that need one.

Path Parameters

handle*string

Header Parameters

X-Client-IP?string

Optional. IP address of the shopper (one IPv4/IPv6, no port, no list). Honoured only together with a valid X-Tenant-Secret; ignored otherwise. Used for rate limits and recorded with form submissions.

X-Tenant-Secret?string

Optional here. Server secret of the store: server-to-server only, never from a browser. Enables X-Client-IP.

Request Body

application/json
  1. body

PUT merchant/pages/{handle}/draft — the full block list (a draft is a whole document, never a patch) plus optional page metadata changes and a revision note.

slug?string
Match^[a-z0-9]+(?:-[a-z0-9]+)*$
Lengthlength <= 191
title?string
Lengthlength <= 255
kind?string
Value in"page""post"
excerpt?|
Lengthlength <= 500
seo?
note?|
Lengthlength <= 500
blocks*array<string>

Response Body

Success.

application/json
  1. response
data*
Example Request
curl -X PUT 'https://api.elaraone.app/api/v1/merchant/pages/string/draft' \  -H 'X-Tenant-Key: pk_live_…' \  -H 'X-Tenant-Secret: your-server-secret' \  -H 'Content-Type: application/json' \  -d '{  "blocks": [    "string"  ]}'
Example Response
{  "data": {    "id": 0,    "handle": "string",    "slug": "string",    "title": "string",    "kind": "string",    "excerpt": "string",    "status": "string",    "seo": {},    "published_at": "string",    "current_revision": [      null    ],    "published_revision": [      null    ],    "revisions": [      {        "id": 0,        "number": 0,        "note": "string",        "author": {          "type": "string",          "id": 0        },        "created_at": "string",        "blocks": [          {            "type": "string",            "data": {              "property1": null,              "property2": null            }          }        ]      }    ],    "created_at": "string",    "updated_at": "string"  }}