---
title: "List My Work items"
method: GET
path: "/work/items"
tags: ["My Work"]
---

# List My Work items

`GET /work/items`

Returns a paginated list of work items assigned to the authenticated user.
Use `assigneeEmail` to filter by a specific user, or omit to default to the authenticated user.

## Query parameters

- `assigneeEmail` string
- `type` 'Checklist' | 'StandardTask' | 'ApprovalTask' | 'OneOffTask' | 'Acknowledgment'
- `workflowId` string
- `dueDateFrom` string
- `dueDateTo` string
- `snoozeStatus` 'Active' | 'Snoozed'
- `includeCompleted` boolean
- `_` string

## 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: query parameter type, Invalid value for: query parameter snoozeStatus, Invalid value for: query parameter includeCompleted
- `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)