Edit, unpublish and delete

What you can change depends on whether the post has gone live. Before publishing, almost everything is editable with one PUT. After publishing, you are limited to what each platform allows: some let you edit the text, a few let you delete, and some allow neither.

#Update a post before it publishes

PUT /v1/posts/{postId} works on draft, scheduled, failed, partial and cancelled posts. Send only the fields you want to change:

curl -X PUT https://api.pozy.ai/v1/posts/6721a8c04e9b2f1d7c3a5e88 \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Webinar moved to Thursday 18:00 CET. Same link, new time.",
    "scheduledFor": "2026-11-12T17:00:00Z"
  }'

const res = await fetch("https://api.pozy.ai/v1/posts/6721a8c04e9b2f1d7c3a5e88", {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${process.env.POZY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    content: "Webinar moved to Thursday 18:00 CET. Same link, new time.",
    scheduledFor: "2026-11-12T17:00:00Z",
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);
console.log(data.post.status, data.post.scheduledFor);

resp = requests.put(
    "https://api.pozy.ai/v1/posts/6721a8c04e9b2f1d7c3a5e88",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    json={
        "content": "Webinar moved to Thursday 18:00 CET. Same link, new time.",
        "scheduledFor": "2026-11-12T17:00:00Z",
    },
    timeout=30,
)
print(resp.json()["post"]["status"])

Rules to keep in mind:

• Full validation runs again. A non-draft update is checked against every target platform, exactly like a create. If the result breaks a platform rule, you get 400 and nothing changes.
• Send the full platforms list. When you include platforms, list every entry the post should end up with, not only the one you changed.
• Settings objects are replaced whole. A platformSpecificData, tiktokSettings or facebookSettings you send overwrites the stored one, so include every key you want to keep.
• Drafts need isDraft: false to schedule. See Drafts and approvals.
• Published posts are read-only, except for their recycling settings.

To publish a scheduled post right away, update it with publishNow: true.

#Edit text after publishing

POST /v1/posts/{postId}/edit changes the text of a live post on one platform. Pass accountId when the post went to more than one account on that platform; without it, the first matching entry is edited.

curl -X POST https://api.pozy.ai/v1/posts/6721a8c04e9b2f1d7c3a5e88/edit \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "platform": "linkedin", "content": "Webinar moved to Thursday 18:00 CET (corrected time). Same link." }'

const res = await fetch("https://api.pozy.ai/v1/posts/6721a8c04e9b2f1d7c3a5e88/edit", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.POZY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ platform: "linkedin", content: "Webinar moved to Thursday 18:00 CET (corrected time). Same link." }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);
console.log(data.success, data.url);

resp = requests.post(
    "https://api.pozy.ai/v1/posts/6721a8c04e9b2f1d7c3a5e88/edit",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    json={"platform": "linkedin", "content": "Webinar moved to Thursday 18:00 CET (corrected time). Same link."},
    timeout=30,
)
print(resp.json())

Media cannot be changed after publishing on any platform.

#Update a YouTube video's details

POST /v1/posts/{postId}/update-metadata changes a published YouTube video without uploading it again. Send platform: "youtube" and at least one of: title (100 characters), description, tags, categoryId, privacyStatus (public, private, unlisted), thumbnailUrl, madeForKids, containsSyntheticMedia or playlistId.

{
  "platform": "youtube",
  "title": "Halving our build times (2026 update)",
  "privacyStatus": "public",
  "thumbnailUrl": "https://pozy.ai/media/temp/1730289600_y9u4_thumb.jpg"
}

It also works for videos uploaded outside Pozy: use _ as the post id and send the YouTube videoId and the channel's accountId in the body. The response lists updatedFields.

#Take a post down

POST /v1/posts/{postId}/unpublish deletes the post from one platform. Pozy keeps the record, with its analytics and history.

curl -X POST https://api.pozy.ai/v1/posts/6721a8c04e9b2f1d7c3a5e88/unpublish \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "platform": "twitter", "accountId": "6710c3e2a9f14b0d8e5c7a23" }'

const res = await fetch("https://api.pozy.ai/v1/posts/6721a8c04e9b2f1d7c3a5e88/unpublish", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.POZY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ platform: "twitter", accountId: "6710c3e2a9f14b0d8e5c7a23" }),
});
if (!res.ok) throw new Error((await res.json()).error);

requests.post(
    "https://api.pozy.ai/v1/posts/6721a8c04e9b2f1d7c3a5e88/unpublish",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    json={"platform": "twitter", "accountId": "6710c3e2a9f14b0d8e5c7a23"},
    timeout=30,
).raise_for_status()

• One call removes one platform. Repeat for each platform you want to clear.
• A thread is removed as a whole: every post of the thread on that platform is deleted.
• YouTube deletions are permanent. The video, its views and its comments are gone.
• When every copy is removed the post becomes cancelled. Until then it is partial.
• For Instagram and TikTok, the owner has to delete the post in the app. Pozy notices within about an hour and sends post.platform.deleted.

#Delete a post

DELETE /v1/posts/{postId} removes the post from Pozy. Use it to cancel a draft or a scheduled post before it goes out.

• It never touches the platforms. A published post returns 400; unpublish it first, or keep the record for its analytics.
• It sends no webhook. If your app mirrors posts, remove the record on your side when the call succeeds.
• A post in publishing can only be stopped for entries that have not started uploading yet.

#Pin a Facebook post

POST /v1/posts/{postId}/pin pins a published post to the top of its Facebook Page, and POST /v1/posts/{postId}/unpin removes the pin. Send platform: "facebook" and, for posts that went to several Pages, the accountId. Other platforms return 400 with code: "platform_not_supported".

#Endpoints

#Webhook events