---
title: "Change post status: PUT /posts/:id/status | Posty Docs"
description: "Moves a post between the draft and scheduled states."
canonical: https://posty.hu/en/docs/api/endpoints/post-status
source: https://posty.hu/en/docs/api/endpoints/post-status.md
---

Posts

# Change post status: PUT /posts/:id/status

Moves a post between the draft and scheduled states.

## Path

Method and path

PUThttps://api.posty.hu/public/v1/posts/:id/status

Authorization

`posts:publish`

operationId

`changePostStatus`

Moves the post between draft and scheduled status.

## Parameters

| Name | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| id | path | string | yes | The post ID. |
| status | body | "draft" \| "schedule" | yes | The new status. |

## Request

```
curl -X PUT https://api.posty.hu/public/v1/posts/clp0s7t8u9v0w1x2/status \
  -H "Authorization: psty_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "status": "schedule" }'
```

Copy Code

## Important

- This endpoint requires the posts:publish scope, not posts:draft. Moving a post out of draft is scheduling, and a key that can only draft cannot bypass that limit through this route.

## Related

- [Authentication](https://posty.hu/en/docs/api/authentication): API key and scopes.
- [Errors and limits](https://posty.hu/en/docs/api/errors): error responses and rate limits.
- [All endpoints](https://posty.hu/en/docs/api/endpoints): full list.

Documentation pages

Is something missing from this page? Email [norbert@posty.hu](mailto:norbert@posty.hu) or use the form on the [Help](https://posty.hu/en/help) page.