Update post settings
PUT /public/v1/posts/{id}/settingsChanges 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.
Path parameters
Section titled “Path parameters”| 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.
Request
Section titled “Request”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" } }'Response
Section titled “Response”{ "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.
When this is refused
Section titled “When this is refused”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’sproviderandnameshape. Content and media are carried over untouched, which means a post whose text was already empty and has no image is refused here too.