---
title: "Update schedule assignees"
method: PATCH
path: "/scheduling/v1/schedules/{schedule_id}/assignees"
tags: ["Schedules"]
---

# Update schedule assignees

`PATCH /scheduling/v1/schedules/{schedule_id}/assignees`

Replaces the assignment rule for a schedule. The selected option replaces the current assignees entirely. Use 'users' to assign specific users, 'groups' to assign all members of a group, 'site_members' to assign all members of the target site(s), or 'site_members_in_group' to assign site members who are also in a group. The site_members and site_members_in_group options require the schedule to have targets (sites or assets) set.

## Path parameters

- `schedule_id` string, required

## Request body

- union — Replaces the assignment rule for a schedule. Exactly one update option must be set.
  - object — Assign specific users by ID. Replaces the current user assignees with the provided list.
    - `users` S12SchedulingV1UpdateUserAssignees, required — UpdateUserAssignees modifies the list of specifically assigned users.
      - `user_ids` string[], required — User IDs to assign. Replaces any existing assignees with this list.
  - object — Assign all members of the specified group. Replaces any current assignment with group-based assignment.
    - `groups` S12SchedulingV1UpdateGroupAssignment, required — UpdateGroupAssignment changes the schedule to assign to all members of a group.
      - `group_ids` string[], required — Group IDs to assign. Currently supports only one group. Replaces any existing assignment strategy.
  - object — Assign all members of the target site(s). Requires the schedule to have targets (sites or assets) set.
    - `site_members` object, required — UpdateSiteMemberAssignment changes the schedule to assign to all members of the target site(s). The schedule must have targets (sites or assets) set for this option to work.
  - object — Assign site members who are also in the specified group (intersection). Requires the schedule to have targets (sites or assets) set.
    - `site_members_in_group` S12SchedulingV1UpdateSiteMemberInGroupAssignment, required — UpdateSiteMemberInGroupAssignment changes the schedule to assign to site members who are also in the specified group (intersection). The schedule must have targets (sites or assets) set for this option to work.
      - `group_ids` string[], required — Group IDs for intersection filtering. Currently supports only one group.

## Response `200`

A successful response.

- S12SchedulingV1UpdateScheduleAssigneesResponse — Response message for UpdateScheduleAssignees.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/safetyculture/apis/safetyculture-api.md) · [All operations](https://skmtc.net/safetyculture/apis/safetyculture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safetyculture/safetyculture-api/revisions/5be91df61ded/schema)