Parameters
| Name | Type | Required | Description |
|---|---|---|---|
brandId | string | Yes | Ocoya brand id from ocoya_list_brands. |
postGroupId | string | Yes | Ocoya post group id. |
caption | string | No | New caption to apply to existing post variations. |
scheduledAt | string or null | No | ISO datetime to schedule the post, or null to make it unscheduled. |
publishNow | boolean | No | Publish the existing post immediately without creating a new post. |
mediaUrls | string[] | No | Full replacement set of publicly reachable image or video URLs. Maximum 10. Use an empty array to remove all media. |
addMediaUrls | string[] | No | Publicly reachable image or video URLs to append without removing existing media. Maximum 10 total. |
clearMedia | boolean | No | Remove all media from the post. Ignored when mediaUrls is provided. |
channelIds | string[] | No | Full replacement set of channel ids from ocoya_list_channels. |
addChannelIds | string[] | No | Channel ids to append without removing channels already attached to the post. |
options | object | No | Per-network settings, keyed by network. Each applies only when the post has a channel on that network; on update only the fields sent change. |
Request example
{
"name": "ocoya_update_post",
"arguments": {
"brandId": "cmayvq3hk00017apshay5qezu",
"postGroupId": "cmajvvb9q0003ja5vh0538j6r",
"caption": "Launching our summer campaign today.",
"scheduledAt": "2026-07-01T09:00:00Z",
"channelIds": ["clh49poxf008x8kov4ncbjty9"]
}
}Returns
Returns postGroupId, status and scheduledAt. This tool changes or removes existing content, and can reach your connected networks.