API Reference
Update Scheduled Post
Update caption, schedule time, platforms, or media for an existing scheduled post.
PATCH/scheduled-posts/:id
Authenticate with a Bearer
sv_ token. See Authentication.Path parameters
| Parameter | Type | Description |
|---|---|---|
idrequired | string | Scheduled post id returned from create or list. |
Request body
Send multipart/form-data. Omitted fields keep their previous values. Image/video posts must still have media after the update.
| Parameter | Type | Description |
|---|---|---|
postTextoptional | string | Updated caption. Defaults to the existing value when omitted. |
postTypeoptional | 'text' | 'image' | 'video' | Updated content kind. |
accountsoptional | string (CSV) | Updated platform CSV. When provided, must match at least one connected account. |
scheduledForoptional | string (ISO 8601) | New publish time (also scheduledAt / scheduled_for / scheduled_at). |
filesoptional | File[] (≤ 10) | Replace media for image/video posts when uploaded. |
metadataoptional | string (JSON) | object | Updated metadata object. |
Examples
cURL
curl -X PATCH https://shareviral-server-production.up.railway.app/api/v1/developer/scheduled-posts/abc123 \
-H "Authorization: Bearer sv_your_api_token" \
-F "postText=Updated caption" \
-F "scheduledFor=2026-07-21T09:00:00.000Z"Response
200 OK
{
"success": true,
"id": "abc123…"
}