/v1/blogs/{subdomain}/posts/{id}Updates a post. Only the fields present in the payload are modified; omitted fields are left unchanged. This call never changes the publication state — use the publish / unpublish endpoints for that. Changing the `slug` is discouraged after publication: a collision with another post returns 400.
| Name | In | Type | Description |
|---|---|---|---|
subdomain* | path | string | — |
id* | path | string | Post id returned at creation |
application/json
Post title
Post body in Markdown
URL-safe slug. Changing it is discouraged after publication (breaks the public URL). A collision with an existing post returns 400.
Short excerpt or teaser text
URL of the post cover image
Tag names. Replaces the current tag set when present.
Tag names. Replaces the current tag set when present.
Content access mode: FREE or PAID.
Unique post identifier
Post title
URL-safe slug
Short excerpt or teaser text, if provided by the author
Full post body in the format described by `contentFormat`
Format of the `content` field. Currently always `markdown`.
Date the post was published (ISO 8601 date). Null if the post is not yet published.
Date and time the post was last updated (ISO 8601 datetime)
URL of the post cover image
Canonical public URL of the post
Content access mode: FREE (visible to all readers) or PAID (requires an active paid subscription)
Total number of claps / reactions the post has received
Tags associated with this post
Human-readable tag name
URL-safe slug — use as the `tag` query parameter when filtering posts
Authors credited on this post
Display name of the author
URL of the author's avatar image
Short one-line biography suitable for bylines
/v1/blogs/{subdomain}/posts/{id}curl -X PATCH \
-H "Accept: application/json" \
"http://localhost:8080/v1/blogs/<subdomain>/posts/<id>"/v1/blogs/{subdomain}/posts/{id}curl -X PATCH \
-H "Accept: application/json" \
"http://localhost:8080/v1/blogs/<subdomain>/posts/<id>"