Parameters
| Name | Type | Required | Description |
|---|---|---|---|
brandId | string | Yes | 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. |
socialProfileIds | string[] | No | Full replacement set of connected social profile IDs from ocoya_list_social_profiles. |
addSocialProfileIds | string[] | No | Connected social profile IDs to append without removing profiles already attached to the post. |
Request example
{
"name": "ocoya_update_post",
"arguments": {
"brandId": "cmayvq3hk00017apshay5qezu",
"postGroupId": "cmajvvb9q0003ja5vh0538j6r",
"addSocialProfileIds": ["clh49poxf008x8kov4ncbjty9"],
"scheduledAt": "2026-07-01T09:00:00Z"
}
}Returns
Returns post action details such as post group ID, status, and schedule.