Parameters

NameTypeRequiredDescription
brandIdstringYesOcoya brand id from ocoya_list_brands.
postGroupIdstringYesOcoya post group id.
captionstringNoNew caption to apply to existing post variations.
scheduledAtstring or nullNoISO datetime to schedule the post, or null to make it unscheduled.
publishNowbooleanNoPublish the existing post immediately without creating a new post.
mediaUrlsstring[]NoFull replacement set of publicly reachable image or video URLs. Maximum 10. Use an empty array to remove all media.
addMediaUrlsstring[]NoPublicly reachable image or video URLs to append without removing existing media. Maximum 10 total.
clearMediabooleanNoRemove all media from the post. Ignored when mediaUrls is provided.
channelIdsstring[]NoFull replacement set of channel ids from ocoya_list_channels.
addChannelIdsstring[]NoChannel ids to append without removing channels already attached to the post.
optionsobjectNoPer-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.