> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ocoya.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ocoya_update_post

> Update editable post fields.

# `ocoya_update_post`

Updates editable post fields: caption, `scheduledAt`, or `brandId`. This tool does not upload or replace media.

## Arguments

| Name          | Type           | Required | Description                                                                   |
| ------------- | -------------- | -------- | ----------------------------------------------------------------------------- |
| `workspaceId` | string         | Yes      | Workspace ID from `ocoya_list_workspaces`.                                    |
| `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.          |
| `brandId`     | string or null | No       | Brand kit ID from `ocoya_list_brand_kits`, or `null` to remove the brand kit. |

## Example

```json theme={null}
{
  "name": "ocoya_update_post",
  "arguments": {
    "workspaceId": "cmayvq3hk00017apshay5qezu",
    "postGroupId": "cmajvvb9q0003ja5vh0538j6r",
    "caption": "Updated caption for launch day."
  }
}
```

## Returns

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