Skip to main content

​
Parameters

NameTypeRequiredDescription
workspaceIdstringYesWorkspace ID from ocoya_list_workspaces.
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.
brandIdstring or nullNoBrand kit ID from ocoya_list_brand_kits, or null to remove the brand kit.
mediaUrlsstring[]NoFull replacement set of publicly reachable image or video URLs. Maximum 5. Use an empty array to remove all media.
addMediaUrlsstring[]NoPublicly reachable image or video URLs to append without removing existing media. Maximum 5 total.
clearMediabooleanNoRemove all media from the post. Ignored when mediaUrls is provided.
socialProfileIdsstring[]NoFull replacement set of connected social profile IDs from ocoya_list_social_profiles.
addSocialProfileIdsstring[]NoConnected social profile IDs to append without removing profiles already attached to the post.

​
Request example

{
  "name": "ocoya_update_post",
  "arguments": {
    "workspaceId": "cmayvq3hk00017apshay5qezu",
    "postGroupId": "cmajvvb9q0003ja5vh0538j6r",
    "addSocialProfileIds": ["clh49poxf008x8kov4ncbjty9"],
    "scheduledAt": "2026-07-01T09:00:00Z"
  }
}

​
Returns

Returns post action details such as post group ID, status, and schedule.