---
title: "Updates the capacity of the specified user."
method: PUT
path: "/users/{userId}/capacity"
tags: ["userCapacities"]
---

# Updates the capacity of the specified user.

`PUT /users/{userId}/capacity`

Updates the capacity of the user with the specified id.
            User planning data or admin permissions are required if the capacity of the specified user
            does not belong to the calling user.

<Check title="Required Permissions" icon="key">Any authenticated user.</Check>

## Path parameters

- `userId` string, uuid, required

## Headers

- `Authorization` string, required

## Request body

- UserCapacityForm — The user capacity form.
  - `capacityPerWeek` integer, nullable — Backward compatibility property. The capacity of the user per week, in seconds. If this value is null, and all the daily values are null as well, then the default value will be set to the default value.
  - `mon` integer, nullable — The user's capacity on Monday, in seconds.
  - `tue` integer, nullable — The user's capacity on Tuesday, in seconds.
  - `wed` integer, nullable — The user's capacity on Wednesday, in seconds.
  - `thu` integer, nullable — The user's capacity on Thursday, in seconds.
  - `fri` integer, nullable — The user's capacity on Friday, in seconds.
  - `sat` integer, nullable — The user's capacity on Saturday, in seconds.
  - `sun` integer, nullable — The user's capacity on Sunday, in seconds.

## Response `200`

OK

- UserCapacity — The user capacity model.
  - `userId` string, uuid — The id of the user this capacity belongs to.
  - `weeklyCapacity` UserWeeklyCapacity
    - `mon` integer — The user's capacity on Monday, in seconds.
    - `tue` integer — The user's capacity on Tuesday, in seconds.
    - `wed` integer — The user's capacity on Wednesday, in seconds.
    - `thu` integer — The user's capacity on Thursday, in seconds.
    - `fri` integer — The user's capacity on Friday, in seconds.
    - `sat` integer — The user's capacity on Saturday, in seconds.
    - `sun` integer — The user's capacity on Sunday, in seconds.
  - `createdOn` string, date-time — The date this user capacity was created.
  - `createdBy` string, uuid — The id of the user who created this user capacity.
  - `updatedOn` string, date-time — The date when this user capacity was last updated.
  - `updatedBy` string, uuid — The id of the user who updated the user capacity.
  - `capacityPerWeek` integer — The capacity of the user per week, in seconds.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/awork-io/apis/api-v1-reference.md) · [All operations](https://skmtc.net/awork-io/apis/api-v1-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/awork-io/api-v1-reference/versions/f784a53f60df/schema)