updateMultiImagePostPhoto
Idempotent
Update an existing album photo by ID to change its title or order. Ideal for renaming or reordering photos.
Instructions
Update an album photo - Update an existing portfoliophoto record by ID. Fields omitted are untouched. Writes live data.
Use when: reordering photos within an album (order field) or renaming (title).
Required: photo_id.
Cannot re-import a failed image. Only writes title and order. To fix an image_imported=0 row: deleteMultiImagePostPhoto, then updateMultiImagePost group_id=<same>&post_image=<new_url>&auto_image_import=1 (appends).
See also: createMultiImagePostPhoto (add new), deleteMultiImagePostPhoto (remove permanently).
Returns: { status: "success", message: {...updatedRecord} } - the full updated record after changes applied.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| photo_id | Yes | ||
| title | No | ||
| order | No | ||
| _clear_fields | No | Column names to clear to empty string. Available on every `update*` operation. Works on base columns AND EAV/`users_meta` rows (rows preserved with `value=""`). To actually clear a field you MUST use this parameter — sending the field with `""` alone is a no-op (BD drops empty values). To remove a `users_meta` row entirely, use `deleteUserMeta`. See **Rule: Clearing fields**. Example: `_clear_fields: ["h2", "hero_link_url"]`. |