---
title: "Create auto-assign request"
method: POST
path: "/scheduler/v1/schedulers/{schedulerId}/shifts/auto-assign"
tags: ["Schedule:v1:Schedulers:Schedule:Shift Auto Assign"]
---

# Create auto-assign request

`POST /scheduler/v1/schedulers/{schedulerId}/shifts/auto-assign`

Initiate a request to auto-assign shifts by their IDs. If multiple IDs are provided, all corresponding shifts must occur within the same work week (e.g., Monday to Sunday). This endpoint only submits the request; processing may take a few minutes. The auto-assignment considers user preferences to work, unavailability, and approved time off. For assignment status, refer to the auto-assign status endpoint.

## Path parameters

- `schedulerId` integer, required — The unique identifier of the schedule

## Request body

- AutoAssignRequest
  - `shiftsIds` string[], required — List of shift IDs to start a request to auto assign. The shifts must be within the same week period (according to the schedule settings).
  - `isForceQualification` boolean, nullable — Determines whether to take into consideration the qualifications of users.
  - `isForceUnavailability` boolean, nullable — Determines whether to consider users' unavailabilities.
  - `isForceLimitations` boolean, nullable — Determines whether to consider users' limitations.
  - `isForceOpenShiftRequests` boolean, nullable — Determines whether to assign open shifts exclusively to requesters. If set to false, it first prioritizes requesters, then assigns the remaining.

## Response `200`

Successful Response

- APIResponseV2AutoAssignResponse
  - `requestId` string
  - `data` AutoAssignResponse, required
    - `autoAssignRequestId` string, required — The unique identifier of the auto assign request

## Other responses

- `422` — Validation Error

---

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