list_action_items
Retrieve action items from a specific conversation, folder, or home container. Filter by status or assignee to find outstanding tasks quickly.
Instructions
List action items belonging to one container — a conversation, a folder, or home.
USE WHEN: You have a container_id and want its action items. container_type is channel for a conversation, folder for a folder, or home. A conversation id is NOT a folder id — resolve container_id with the tool matching your container_type. Filter by status or assigned_to (pass the string null for unassigned).
USE INSTEAD: list_my_action_items for everything assigned to you regardless of where it lives.
FIRST: container_id comes from list_conversations (field results[].id) when container_type is channel — call it first if you don't have one.
FIRST: container_id comes from get_root_folders (field results[].id) when container_type is folder — call it first if you don't have one.
EXAMPLE: {"container_type":"channel","container_id":"conv-abc","status":"todo"}
RETURNS: Same as list_my_action_items: {results: [...], total?, results_count?, has_more?, next_cursor?, filters?}.
NARROW: pass response_fields ["results.id","results.title","results.status","results.assigned_to"] unless you need more — the full payload is much larger.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Anchor timestamp to start from. Uses updated_at. Ignored when starting_after/ending_before is provided. | |
| limit | No | Number of items to return (min: 1, max: 100) | |
| status | No | ||
| direction | No | newer | |
| assigned_to | No | Filter by assigned_to (user_id). Use 'null' to filter by unassigned items. | |
| container_id | Yes | ||
| ending_before | No | Cursor to fetch the previous page (use value from previous_cursor). | |
| container_type | Yes | ||
| starting_after | No | Cursor to fetch the next page (use value from next_cursor). | |
| response_fields | No | Dot-path allowlist to shrink the response, e.g. ["results.id","total"]. Omit for the full payload. |