Skip to main content

Assign Work to Users

Each work item can have multiple people assigned to it in different roles. This guide shows you how to add, update, and remove assignments.

Assignee roles​

RoleDescription
ASSIGNEEThe person doing the work (default)
REVIEWERThe person reviewing the work
REPORTERThe person who reported or created the work item

A user can hold one role per work item. The same user cannot be both ASSIGNEE and REVIEWER on the same work item — they are separate assignment records. However, the combination of (work_item_id, user_id, assignee_role) must be unique.

Add an assignee​

POST /rest/v1/t_ppm_work_item_assignees
{
  "work_item_id": "e5f6a7b8-...",
  "user_id": "u1v2w3x4-...",
  "assignee_role": "ASSIGNEE"
}
Response (201 Created)
{
  "id": "asgn-0001-...",
  "work_item_id": "e5f6a7b8-...",
  "user_id": "u1v2w3x4-...",
  "assignee_role": "ASSIGNEE",
  "created_date": "2026-05-03T09:00:00+00:00"
}

Add a reviewer​

POST /rest/v1/t_ppm_work_item_assignees
{
  "work_item_id": "e5f6a7b8-...",
  "user_id": "r4s5t6u7-...",
  "assignee_role": "REVIEWER"
}

Add a reporter​

POST /rest/v1/t_ppm_work_item_assignees
{
  "work_item_id": "e5f6a7b8-...",
  "user_id": "p8q9r0s1-...",
  "assignee_role": "REPORTER"
}

Remove an assignment​

Delete the assignment record:

DELETE /rest/v1/t_ppm_work_item_assignees?id=eq.<assignment-id>

Or target by the unique combination:

DELETE /rest/v1/t_ppm_work_item_assignees?work_item_id=eq.<work-item-id>&user_id=eq.<user-id>&assignee_role=eq.ASSIGNEE

List assignees for a work item​

GET /rest/v1/t_ppm_work_item_assignees?work_item_id=eq.e5f6a7b8-...

List work items assigned to a user​

GET /rest/v1/t_ppm_work_item_assignees?user_id=eq.u1v2w3x4-...&select=*,work_item:t_ppm_work_items(*)
note

Assignment changes are recorded automatically in the work item's activity stream as ASSIGNMENT events.