---
title: "Set a repeating schedule's per-person cap"
method: PUT
path: "/signups/{id}/slot_series/{seriesId}/max_per_person"
tags: ["Slots"]
---

# Set a repeating schedule's per-person cap

`PUT /signups/{id}/slot_series/{seriesId}/max_per_person`

## Request

- Base URL: `https://thesignup.app/api/v1`
- URL: `https://thesignup.app/api/v1/signups/{id}/slot_series/{seriesId}/max_per_person`
- Auth: HTTP bearer

Set how many Occurrences one person may take, on the Series and on every live, non-detached Occurrence; `0` is no limit. A cap below what someone already holds is kept: it limits further signups, it does not remove anyone. Notifies nobody.

## Path parameters

- `id` string, uuid, required
- `seriesId` string, uuid, required

## Request body

- SetSlotSeriesMaxPerPersonRequest
  - `maxPerPerson` integer, required

## Response `200`

The updated Series

- SlotSeries
  - `id` string, uuid, required
  - `eventId` string, uuid, required
  - `frequency` 'daily' | 'weekly' | 'monthly', required
  - `interval` integer, required
  - `rangeStart` string, required
  - `rangeEnd` string, required
  - `capacity` integer, required
  - `maxPerPerson` integer, required
  - `rule` object, required: The stored shift plan, in the shape `rule` was sent.
  - `timezone` string, nullable, required
  - `location` string, nullable, required
  - `dayQuestion` object, nullable, required: The Series' default Day Question, or null. A day's own question shadows it.
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400`: Bad request — body or path could not be parsed
- `401`: Unauthenticated — credentials missing, malformed, invalid, or revoked
- `403`: Forbidden — credentials valid but lack the required scope
- `404`: Not found
- `422`: Validation failed — request body / query / path is structurally wrong
- `429`: Rate limited or daily ceiling exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/thesignup/apis/thesignup-api.md) · [All operations](https://skmtc.dev/thesignup/apis/thesignup-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thesignup/apis/thesignup-api/revisions/c6da7cf92172?raw)
