---
title: "Search My Work items"
method: POST
path: "/work/items/search"
tags: ["My Work"]
---

# Search My Work items

`POST /work/items/search`

Searches work items with complex filtering.
Supports multi-value filters for assignees, types, and workflows, plus free-text search and sorting.

## Query parameters

- `_` string

## Request body

- SearchMyWorkItemsRequest
  - `assigneeEmails` string[] — Filter results to items assigned to one or more user emails. Unknown emails are silently ignored (the search returns whatever the known assignees have). Defaults to the authenticated user if empty.
  - `types` string[]
  - `workflowIds` string[] — Filter to specific workflows. Unknown/inaccessible workflow IDs are silently ignored.
  - `dueDateFrom` string, date-time — Due date range start (ISO-8601, e.g. 2024-01-15).
  - `dueDateTo` string, date-time — Due date range end (ISO-8601, e.g. 2024-01-31).
  - `snoozeStatus` 'Active' | 'Snoozed' — Snooze filter for the search. - `Active` — non-snoozed items only. - `Snoozed` — items currently snoozed.
  - `includeCompleted` boolean — Include completed items. Defaults to false.
  - `searchTerm` string — Free-text search term applied to task and workflow names.
  - `sortBy` 'DueDate' | 'Name' — Sort key. - `DueDate` — sort by assignment due date. - `Name` — sort by task name (falls back to workflow run name if the task has no name).
  - `sortOrder` 'Asc' | 'Desc' — Sort direction. - `Asc` — ascending. - `Desc` — descending.

## Response `200`

- PublicApiMyWorkItemListResponse
  - `data` object[] — The list of resources returned by this request.
    - `id` string, required — The ID of the My Work item assignment.
    - `type` 'Checklist' | 'StandardTask' | 'ApprovalTask' | 'OneOffTask' | 'Acknowledgment', required — Kind of My Work item. - `Checklist` — a workflow run assigned to the user. - `StandardTask` — a regular task within a workflow run. - `ApprovalTask` — an approval task awaiting the user's review. - `OneOffTask` — a standalone one-off task. - `Acknowledgment` — a revision-acknowledgment request after a workflow update.
    - `name` string, required — Display name of the assigned item (task name, run name, or one-off task name).
    - `workflowId` string, required — The ID of the Workflow
    - `workflowRunId` string — The ID of the Workflow Run.
    - `taskId` string — The ID of the Task.
    - `dueDate` string, date-time — Optional due date of the underlying item. ISO-8601 UTC.
    - `snoozedUntil` string, date-time — If the item is currently snoozed, the date it un-snoozes. Absent if not snoozed.
    - `assignees` object[] — Users assigned to this item.
      - `id` string, required — The resource's ID.
      - `email` string, required — The user's email address (also their login identifier).
      - `username` string, required — The user's display name (e.g. `Jane Doe`).
    - `links` object[] — Navigable HATEOAS links to related resources. Each entry has a `name` (RFC-5988 link relation like `self`, `edit`, `related`), an `href` URL, and a `type` (`Api` for callable endpoints, `App` for browser-facing URLs). Prefer following these `href` values over constructing URLs by hand.
      - `name` string, required — Standard link relation name (RFC 5988) indicating this link's role. Common values include `self`, `edit`, `related`, `previous`, `next`.
      - `href` string, required — URL of the linked resource.
      - `rel` 'Approval Task' | 'Approvals' | 'Assignees' | 'Comment' | 'Data Set Records' | 'Data Sets' | 'Form Field Values' | 'Subject Task' | 'Task' | 'Tasks' | 'Users' | 'Webhook' | 'Workflow' | 'Workflow Run' — Optional. The kind of resource this link points to (e.g. `Workflow`, `Task`, `Comment`).
      - `type` 'Api' | 'App', required — Whether this link targets an API endpoint or a Process Street app URL. `Api` — a callable API endpoint you can fetch directly. `App` — a browser-facing URL in the Process Street UI.
  - `links` object[] — Pagination links. When the result has more pages, look for an entry with `name: "next"` — its `href` is the URL to fetch the next page. Absence of `next` means there are no more pages. For single-resource responses this array is typically empty.
    - `name` string, required — Standard link relation name (RFC 5988) indicating this link's role. Common values include `self`, `edit`, `related`, `previous`, `next`.
    - `href` string, required — URL of the linked resource.
    - `rel` 'Approval Task' | 'Approvals' | 'Assignees' | 'Comment' | 'Data Set Records' | 'Data Sets' | 'Form Field Values' | 'Subject Task' | 'Task' | 'Tasks' | 'Users' | 'Webhook' | 'Workflow' | 'Workflow Run' — Optional. The kind of resource this link points to (e.g. `Workflow`, `Task`, `Comment`).
    - `type` 'Api' | 'App', required — Whether this link targets an API endpoint or a Process Street app URL. `Api` — a callable API endpoint you can fetch directly. `App` — a browser-facing URL in the Process Street UI.

## Other responses

- `400` — Invalid value for: body
- `default`

---

[API](https://skmtc.net/process/apis/process-street-public-api.md) · [All operations](https://skmtc.net/process/apis/process-street-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/process/process-street-public-api/revisions/6199a9464227/schema)