Search items
search_itemsRead-onlyIdempotent
Find items. Every filter is optional and they combine with AND. Finished work (done/cancelled) is left out unless include_finished is true or you ask for a finished category. Sorted by most recently updated unless sort says otherwise. Answers short cards; call get_item for the full story.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| due | No | Due inside a window, counted in your timezone. | |
| sort | No | Sort order. Defaults to updated, newest first. | |
| text | No | Words in the title. | |
| type | No | An item type name, like "Bug". | |
| label | No | A label name. | |
| level | No | Only epics, tasks or subtasks. | |
| limit | No | Defaults to 25. | |
| offset | No | For the next page. | |
| status | No | A column name, like "Code review". | |
| project | No | A project key, like APP. | |
| release | No | A release name. | |
| archived | No | Only archived items, e.g. to restore one. | |
| assignee | No | "me", "none", an email or a name. | |
| category | No | Every column of this kind. | |
| priority | No | One or more of: none, low, normal, high, urgent. | |
| due_after | No | YYYY-MM-DD, inclusive. | |
| due_before | No | YYYY-MM-DD, inclusive. | |
| updated_since | No | YYYY-MM-DD. | |
| include_finished | No | Also return done and cancelled items. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | Short cards. | |
| nextOffset | No | Pass as offset for the next page; absent on the last one. |