---
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

- `401` — Missing or invalid authentication
- `429` — Rate limit exceeded — see the Retry-After header

---

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