swsd_list_my_incidents
List incidents assigned to the authenticated user, supporting filters for state, priority, and more. Handles API limitations by client-side filtering on assignee email.
Instructions
List incidents assigned to the authenticated user. Internally calls swsd_get_me to discover the user's email, then calls /incidents.json with the OTHER server-side filters applied (state, priority, etc.) and narrows the response client-side by assignee.email — because SWSD's /incidents.json endpoint silently ignores assignee_email / requester_email filters (verified 2026-05-08 against the live API: a fake email returns the entire tenant). The client-side filter is the only correct way to scope to a specific user. For broader queries use swsd_list_incidents with assigned_to=<group_id> (group filtering does work server-side).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (1-indexed). | |
| per_page | No | Results per page (1-100). SWSD caps at 100. | |
| states | No | Filter to incidents matching ANY of these states (e.g. ["New", "Assigned"]). | |
| priorities | No | Filter to incidents matching ANY of these priorities (e.g. ["High", "Medium"]). | |
| categories | No | Filter to incidents matching ANY of these category names. | |
| requester_email | No | Filter to incidents requested by this email. | |
| updated_from | No | Filter to incidents updated on or after this ISO date or datetime (YYYY-MM-DD or RFC 3339). | |
| updated_within | No | Convenience alias for updated_from. Accepts "Nh" (hours), "Nd" (days), or "Nw" (weeks). Examples: "24h", "7d", "1w", "30d". Ignored if updated_from is explicitly set. | |
| updated_to | No | Filter to incidents updated on or before this ISO date or datetime. Pair with updated_from for an explicit range. | |
| created_from | No | Filter to incidents created on or after this ISO date or datetime (YYYY-MM-DD or RFC 3339). | |
| created_to | No | Filter to incidents created on or before this ISO date or datetime. | |
| sites | No | Filter to incidents at any of these site names (use swsd_list_sites to discover). | |
| departments | No | Filter to incidents in any of these department names. | |
| assigned_to_group | No | Filter to incidents assigned to this group ID. Use swsd_list_groups to find the ID. NOTE: this is GROUP id, not user id. | |
| state_is_not | No | Negative state filter: exclude incidents in any of these states (e.g. ["Resolved", "Closed"] to see only open work). | |
| sort_by | No | Sort key. Default is SWSD-side (typically updated_at desc). | |
| sort_order | No | Sort direction. Use uppercase per SWSD convention. | |
| query | No | Free-text search across incident title and description. Same async-indexing caveat as solution search — just-created tickets may not appear for a few minutes. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| incidents | Yes | ||
| pagination | Yes | ||
| applied_filters | Yes | Echo of the filters applied to this query — empty object if none. Use this to reason about whether the result count reflects your filters or the tenant total. NOTE: assignee_email is applied client-side (post-fetch) because SWSD ignores it server-side. | |
| assignee_email | Yes | The authenticated user's email used as the assignee filter (applied client-side). | |
| scan | Yes | Honest accounting of the client-side filter: what was scanned vs matched. |