---
title: "Update weekly availability"
method: PUT
path: "/candidates/{candidateId}/availability/weekly"
tags: ["Candidate API:Availability"]
---

# Update weekly availability

`PUT /candidates/{candidateId}/availability/weekly`

Set the candidates availability schedule for a single week

## Path parameters

- `candidateId` integer, required

## Request body

- SetCandidateAvailabilityByWeekCommand
  - `weekOf` string, date, required — Update availability for the week (beginning Sunday) containing the specified date
  - `availability` object, required — Weekly availability, at most two shifts per day
    - `Sunday` TimeRangeModel[] — Availability, specify at most two shifts
      - `start` string, time — Start time of day interval ([ISO partial-time](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6))
      - `end` string, time — End time of day interval ([ISO partial-time](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6))
    - `Monday` TimeRangeModel[] — Availability, specify at most two shifts
      - `start` string, time — Start time of day interval ([ISO partial-time](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6))
      - `end` string, time — End time of day interval ([ISO partial-time](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6))
    - `Tuesday` TimeRangeModel[] — Availability, specify at most two shifts
      - `start` string, time — Start time of day interval ([ISO partial-time](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6))
      - `end` string, time — End time of day interval ([ISO partial-time](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6))
    - `Wednesday` TimeRangeModel[] — Availability, specify at most two shifts
      - `start` string, time — Start time of day interval ([ISO partial-time](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6))
      - `end` string, time — End time of day interval ([ISO partial-time](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6))
    - `Thursday` TimeRangeModel[] — Availability, specify at most two shifts
      - `start` string, time — Start time of day interval ([ISO partial-time](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6))
      - `end` string, time — End time of day interval ([ISO partial-time](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6))
    - `Friday` TimeRangeModel[] — Availability, specify at most two shifts
      - `start` string, time — Start time of day interval ([ISO partial-time](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6))
      - `end` string, time — End time of day interval ([ISO partial-time](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6))
    - `Saturday` TimeRangeModel[] — Availability, specify at most two shifts
      - `start` string, time — Start time of day interval ([ISO partial-time](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6))
      - `end` string, time — End time of day interval ([ISO partial-time](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6))
  - `recurring` boolean — Availability repeats in following weeks. Previous/past recurring schedules will be terminated prior to this schedule, existing future overlapping schedules will be cancelled.
  - `until` string, date, nullable — Optional end date of repeating availability

## Other responses

- `404` — Candidate was not found

---

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