---
title: "Edit a Social Post"
method: PATCH
path: "/social/posts/{postId}"
tags: ["Social"]
---

# Edit a Social Post

`PATCH /social/posts/{postId}`

Change a draft or scheduled post before it goes out

## Path parameters

- `postId` string, required

## Request body

- object
  - `content` string — Replacement caption, max 5000 characters
  - `media_urls` unknown[] — Replacement media. Send an empty array to remove the media
    - unknown
  - `media_url` string — Single-media shorthand for `media_urls`
  - `accounts` unknown[] — Replacement target account IDs. Replaces the existing set rather than adding to it
    - unknown
  - `status` string — `draft` or `scheduled`. Omit to keep the post's current timing
  - `scheduled_for` string — New ISO 8601 publish time, at least 60 seconds ahead. Required with `status: "scheduled"`
  - `timezone` string — IANA timezone for the schedule
  - `platformOptions` object — Per-account platform options, keyed by account ID

## Response `200`

Successful response

- object

## Other responses

- `400` — The request was malformed or a parameter was invalid.
- `401` — Authentication is required and was not supplied.
- `403` — The API key is missing, invalid, or not permitted to perform this action.
- `404` — The requested route or resource does not exist.
- `429` — The workspace rate limit was exceeded. Retry after the interval given by the Retry-After header.
- `500` — An unexpected error occurred on our side.

## Changes

> 7 revisions in range; 3 could not be searched.

- **2026-08-12** `fab85c44ee78` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/orshot/apis/orshot-api/changes/social/posts/:postId/patch.md)

---

[API](https://skmtc.dev/orshot/apis/orshot-api.md) · [All operations](https://skmtc.dev/orshot/apis/orshot-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/orshot/orshot-api/revisions/7c4d4e1c76fc/schema)