Update content draft
Changes a draft’s title, meta description, slug or plain CMS fields. Send only what you want to change. The draft changes at once, also for teammates who have it open in the editor; the live page changes only when the draft is published.
fieldstakes the targets Get content outline lists withkindplainandwritabletrue, matched exactly.- The slug of a published draft cannot change: the page is live at its address.
- Values are plain text: html tags and control characters are refused.
Requires the write:content scope, and the workspace must be enabled for API writes.
PATCH /v1/brands/{brand_id}/content/{draft_id}Authorization
| Header | Type | Required |
|---|---|---|
Authorization | Bearer asky_sk_… | required |
Idempotency-Key | string | required |
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
brand_id | uuid | required | From List brands |
draft_id | uuid | required | From List content drafts |
Query parameters
None.
Body
application/json. At least one field is required.
| Field | Type | Required | Description |
|---|---|---|---|
title | string, up to 300 chars | optional | Cannot be empty |
meta_description | string, up to 500 chars | optional | |
slug | string, up to 200 chars | optional | Lowercase letters, digits and single hyphens |
fields | array, up to 20 | optional | { "target": "...", "value": "..." }, value up to 5,000 chars |
Request
curl --request PATCH \
--url 'https://api.askylabs.com/v1/brands/242546de-4cee-4a7d-952e-f6aa60c63ef8/content/7c1e2b90-3f4d-4a8e-9b21-5d6f7a8b9c0d' \
--header 'Authorization: Bearer <api-key>' \
--header 'Idempotency-Key: <unique-per-attempt>' \
--header 'Content-Type: application/json' \
--data '{"meta_description":"How to pick a CRM your small team will actually use, with a five-point checklist."}'Response
200
{
"data": {
"draft_id": "7c1e2b90-3f4d-4a8e-9b21-5d6f7a8b9c0d",
"updated": ["meta_description"],
"version": 14,
"review_url": "https://app.askylabs.com/content/7c1e2b90-3f4d-4a8e-9b21-5d6f7a8b9c0d",
"live_page_updated": false,
"translations_unchanged": [{ "draft_id": "1d2e3f40-5a6b-4c7d-8e9f-0a1b2c3d4e5f", "language": "de" }]
},
"request_id": "req_7d21b0af59c34e18b6ac"
}Response fields
| Field | Type | Description |
|---|---|---|
data.draft_id | uuid | required |
data.updated | string[] | required. What changed: title, meta_description, slug, and webflow:<field>, sanity:<field> or wordpress:<field> |
data.version | integer | required. The draft’s version after the change |
data.review_url | string | required. The draft in the app |
data.live_page_updated | boolean | required. Always false: publishing the draft updates the live page |
data.translations_unchanged | array | required. The draft’s translations, which this change does not touch |
request_id | string | required |
Last updated on