---
title: "Update post settings"
method: PUT
path: "/posts/{id}/settings"
tags: ["Posts"]
---

# Update post settings

`PUT /posts/{id}/settings`

Merges the given keys into the post's existing provider settings. Only the keys you pass are changed; content and publish date are untouched, so a running publishing workflow is not restarted. The merged settings are re-validated. Works only on not-yet-published posts (scheduled or draft).

## Path parameters

- `id` string, required

## Request body

- object
  - `settings` object, required — Provider settings to merge into the post's existing settings. Only the keys you pass are changed; everything else stays. Keys depend on the channel's platform.

## Response `200`

Post settings updated successfully

- object
  - `postId` string
  - `publishDate` string

## Other responses

- `400` — The id belongs to a comment (pass the root post id), the post is already published or its publish time passed, or the merged settings failed validation
- `404` — Post not found

---

[API](https://skmtc.net/postiz/apis/postiz-public-api.md) · [All operations](https://skmtc.net/postiz/apis/postiz-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/postiz/postiz-public-api/revisions/8b2952dc5357/schema)