set_item_pinned
Toggle the pin status of tasks, habits, chores, or events in the sidebar. Specify the item ID and whether it should be pinned or unpinned.
Instructions
Pin or unpin a sidebar item (Task/Habit/Chore/Event).
item_id accepts any reference form — UUID, sequence shorthand
(#123, personal-org only), canonical ref (acme-123), or app URL
— and is resolved to a UUID before the pin toggle.
Backend body is {pinned: bool} -- the gap-closure plan's optional
label argument is not part of this endpoint (custom pin labels
live on PATCH /tasks/pinned/{id}). Returns {"ok": true} on
success (backend response is 204 NO_CONTENT).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| item_id | Yes | ||
| pinned | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |