Skip to main content
PATCH
Update post

Authorizations

Authorization
string
header
required

Your Marble API key

Path Parameters

identifier
string
required

Post ID or slug

Example:

"my-post-slug"

Body

application/json
title
string
Minimum string length: 1
Example:

"Updated Post Title"

content
string
Minimum string length: 1
Example:

"<p>Updated content</p>"

description
string
Minimum string length: 1
Example:

"Updated description"

slug
string
Minimum string length: 1
Example:

"updated-post-slug"

categoryId
string
Minimum string length: 1
Example:

"cryitfjp2345kl05weoybfk9"

status
enum<string>

Use 'scheduled' with a future publishedAt, sent or already stored, to go live at that time. Publishing a scheduled post early sets publishedAt to now unless you send one.

Available options:
published,
draft,
scheduled
Example:

"published"

tags
string[]

Array of tag IDs. Replaces all existing tags when provided.

Example:
authors
string[]

Array of author IDs. Replaces all existing authors when provided.

Example:
Example:

true

coverImage
string<uri> | null
Example:

"https://media.marblecms.com/new-cover.jpg"

publishedAt
string<date-time>

ISO 8601 datetime. May end in Z or an offset such as +01:00. With neither, as in 2026-11-01T09:00:00, it is read in the workspace timezone. A local time that daylight saving skips returns 400.

Example:

"2024-02-01T10:00:00Z"

fields
object

Custom field values keyed by field key. Select values must use option values; multiselect values must be arrays of option values. Use null to clear optional fields.

Example:

Response

Post updated successfully

post
object
required