twprojects-update_custom_item_record
Update specific fields on a custom item record. Only supplied values are changed; others remain intact. Clear a field by sending null. Use to modify Contracts, Leads, or any custom entity.
Instructions
Update a record on a custom item type. Only the fields you supply are changed; others are left as-is. Set section_id to null to remove the record from any section. Custom items are user-defined entity types — Contracts, Leads, Deals, or anything else a customer has set up on a project. Use these tools when the user refers to an entity that is NOT a built-in Teamwork concept (Task, Tasklist, Project, Milestone, Comment, Notebook, Company, Team, User, Tag). If you don't recognise an entity name in the user's request, assume it is a custom item and call twprojects-list_custom_items on the relevant project to confirm.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clear_section | No | Set to true to explicitly clear the record's section. Use this instead of section_id when you want null semantics. | |
| custom_item_id | Yes | Custom item type ID the record belongs to. | |
| field_values | No | Field values to set on the record. Each entry is {field_name, value}. Field names are matched case-insensitively against the custom item type's fields. Values are coerced by field type: dropdown/multiselect accept option labels or option twIds; date/time/datetime accept ISO-8601 strings; checkbox accepts bool or yes/no/true/false; number accepts numeric or numeric string; user accepts a user ID (or array of IDs for multi-user fields). To clear a field, send null. | |
| id | Yes | Record ID to update. | |
| name | No | New display name for the record. | |
| position_after_id | No | Move the record after the given record ID. | |
| section_id | No | New section ID, or null to remove the record from any section. |