Update item
update_itemIdempotent
Changes any fields of one item; leave out what should stay. assignees/labels replace the whole set, add_*/remove_* adjust it. status or category moves it. clear empties fields. Every name is checked before anything is written. Answers the item as get_item does.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | Like APP-123. | |
| type | No | An item type name. | |
| clear | No | Fields to empty. | |
| title | No | A new title. | |
| labels | No | Replaces every label. | |
| parent | No | Key of the new parent. | |
| status | No | A column name. | |
| release | No | A release name. | |
| category | No | Move to the first column of this kind. | |
| due_date | No | YYYY-MM-DD, "today" or "tomorrow". | |
| priority | No | none, low, normal, high or urgent. | |
| assignees | No | Replaces everyone: "me", emails or names. | |
| add_labels | No | Label names to add. | |
| start_date | No | YYYY-MM-DD, "today" or "tomorrow". | |
| description | No | Markdown. @[Name] mentions someone. | |
| add_assignees | No | People to add: "me", emails or names. | |
| remove_labels | No | Label names to take off. | |
| estimate_minutes | No | Estimated effort in minutes, e.g. 90. | |
| remove_assignees | No | People to take off: "me", emails or names. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | The item id. | |
| key | Yes | The item key. | |
| url | Yes | A link that opens it in the app. | |
| type | No | The item type. | |
| level | Yes | epic, task or subtask. | |
| pulls | No | Linked pull requests. | |
| title | Yes | The title. | |
| branch | Yes | The git branch name to use. | |
| labels | No | Label names. | |
| parent | No | The parent key. | |
| status | No | The column name. | |
| dueDate | No | YYYY-MM-DD. | |
| history | No | Only with include_history. | |
| project | Yes | The project key. | |
| release | No | The release name. | |
| category | No | The kind of column. | |
| children | No | Subtasks or tasks under it. | |
| comments | No | The 20 newest comments with ids. | |
| priority | No | none, low, normal, high or urgent. | |
| assignees | No | Display names. | |
| createdAt | No | ISO 8601, UTC. | |
| startDate | No | YYYY-MM-DD. | |
| updatedAt | No | ISO 8601, UTC. | |
| attachments | No | Files on the item. | |
| completedAt | No | ISO 8601, UTC. | |
| description | No | Markdown. | |
| loggedMinutes | No | Time logged by everyone. | |
| estimateMinutes | No | The estimate. |