SoftSolzSoftSolz
Sign up
HomeAPI GuideAPI ReferenceWidget Tester
Blogs

Update blog-wide settings. Provided keys are changed.

Update blog-wide settings. Provided keys are changed.

PATCHhttps://app.softsolz.uk/api/v1/services/blogs/settings

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Headers

Authorizationstringrequired

Bearer token: `Bearer sk_live_...` (or `sk_test_...` for sandbox). A login token will not work here.

Idempotency-Keystring

Optional idempotency key for safe retries.

Body Params

comments_enabledboolean

Default for "Allow comments" on newly created posts.

comments_require_approvalboolean

When true, reader comments are held as pending and only appear after a moderator approves them.

subscribe_enabledboolean

Whether the newsletter subscribe box is shown on the blog.

author_namestring

Blog-wide default byline name used when a post has no author.

author_image_urlstring

Blog-wide default byline avatar image URL.

Response

Response Body

comments_enabledbooleanDefault for "Allow comments" on newly created posts.
comments_require_approvalbooleanWhen true, reader comments are held as pending and only appear after a moderator approves them.
subscribe_enabledbooleanWhether the newsletter subscribe box is shown on the blog.
author_namestringBlog-wide default byline name.
author_image_urlstringBlog-wide default byline avatar image URL.
show_toc_defaultbooleanDefault for "Show table of contents" on newly created posts.
show_share_defaultbooleanDefault for "Show reader share buttons" on newly created posts.
show_date_defaultbooleanDefault for "Show publish date" on newly created posts.
show_reading_time_defaultbooleanDefault for "Show reading time" on newly created posts.
share_channelsarray of stringsNetworks offered in the reader share bar.

Request

curl --request PATCH \
  --url https://app.softsolz.uk/api/v1/services/blogs/settings \
  --header 'Authorization: Bearer sk_live_your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "comments_enabled": true,
  "comments_require_approval": true,
  "subscribe_enabled": true,
  "author_name": "The SoftSolz team"
}'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
  "data": {
    "comments_enabled": true,
    "comments_require_approval": true,
    "subscribe_enabled": true,
    "author_name": "your-author-name",
    "author_image_url": "https://example.com",
    "show_toc_default": true,
    "show_share_default": true,
    "show_date_default": true,
    "show_reading_time_default": true,
    "share_channels": [
      "your-share-channels"
    ]
  }
}