Skip to content

Update post settings

PUT /public/v1/posts/{id}/settings

Changes the provider options on an existing post: a YouTube title, a Reddit flair, a Pinterest board. It does not touch the post’s text, its media, its channel or its date.

Also available as postSettingsTool (MCP); the CLI has no command for it.

Parameter Required Description
id Yes The id of the main post, not one of its thread replies.
Field Required Description
settings Yes An object. The keys you send are merged over the post’s existing settings.

What each provider accepts is documented one page per channel, listed under the channels Sharek offers. For a specific channel’s live schema, call channel settings.

Terminal window
curl -X PUT https://dash.sharek.app/api/public/v1/posts/post-id/settings \
-H "Authorization: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"settings": {
"title": "A better title",
"type": "public"
}
}'
{ "postId": "post-id", "publishDate": "2026-09-01T10:00:00" }

Note that publishDate comes back without a timezone suffix or milliseconds here, unlike the fully qualified timestamps every other operation returns. It is still UTC.

The post has to be one that has not gone out yet, and it has to be the main post.

Response Meaning
404 {"statusCode": 404, "message": "Post not found", "error": "Not Found"} No such post in your organization, including one you already deleted.
400 This id belongs to a comment, pass the id of the main post You used a reply’s id. Use the id the create call returned for the channel.
400 Only scheduled posts that were not published yet (or drafts) can be updated The post is already published or in an error state.
400 The publish time of this post already passed, it cannot be updated The post is still queued but its time is in the past, so it is no longer editable.
  • Settings are merged, not replaced. Send only the keys you want to change and the rest of the post’s settings are preserved. There is no way to remove a key this way, only to overwrite it.
  • Do not include __type. Sharek always sets it from the post’s own channel and overwrites whatever you send.
  • On a scheduled post the merged settings go through the same settings, media and length checks as a create, so a change that breaks the provider’s rules is rejected rather than saved. On a draft only the empty-content check runs. A refusal here reads {"statusCode": 400, "message": "<channel name>: <reason>", "error": "Bad Request"}, not the create’s provider and name shape. Content and media are carried over untouched, which means a post whose text was already empty and has no image is refused here too.