updateTagRelationship
Idempotent
Update an existing tag relationship record's metadata by ID. Adjust fields or clear them to modify the association between a tag and its linked object.
Instructions
Update a tag relationship - Update an existing tagrelationship record by ID. Fields omitted are untouched. Writes live data.
Use when: adjusting a tag-relationship record's metadata.
Required: id.
See also: createTagRelationship (add new), deleteTagRelationship (remove permanently).
Returns: { status: "success", message: {...updatedRecord} } - the full updated record after changes applied.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| object_id | No | Primary key of the record being tagged. Which table it lives in depends on tag_type_id - look up via listTagTypes. For tag_type_id=1 (Users), object_id is a user_id from users_data. | |
| _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"]`. |