---
title: "Update post"
method: PATCH
path: "/post/{postId}"
---

# Update post

`PATCH /post/{postId}`

Returns an id of the updated post

## Path parameters

- `postId` string, required

## Request body

- object
  - `caption` string — New caption to apply to existing post variations.
  - `scheduledAt` string, nullable — ISO 8601 datetime when the post should be scheduled, or `null` to make it unscheduled.
  - `publishNow` boolean — Publish the existing post immediately without creating a new post.
  - `brandId` string, nullable — Brand kit ID to apply, or `null` to remove the brand kit.
  - `mediaUrls` string[] — Full replacement set of publicly reachable image or video URLs. Maximum 5. Use an empty array to remove all media.
  - `addMediaUrls` string[] — Publicly reachable image or video URLs to add without removing existing media. Maximum 5 total.
  - `clearMedia` boolean — Remove all media from the post. Ignored when mediaUrls is provided.
  - `socialProfileIds` string[] — Full replacement set of connected social profile IDs that should receive the post. Get IDs from `GET /social-profiles`.
  - `addSocialProfileIds` string[] — Connected social profile IDs to add without removing profiles already attached to the post.

## Response `200`

Success

## Other responses

- `500` — Unknown error

---

[API](https://skmtc.net/ocoya/apis/ocoya-api.md) · [All operations](https://skmtc.net/ocoya/apis/ocoya-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ocoya/ocoya-api/versions/80ba891a0523/schema)