---
title: "Add limited users"
method: POST
path: "/v1/workspaces/{workspaceId}/limited-users"
tags: ["Workspace"]
---

# Add limited users

`POST /v1/workspaces/{workspaceId}/limited-users`

## Path parameters

- `workspaceId` string, required — Represents a workspace identifier across the system.

## Request body

- AddLimitedUsersRequest
  - `users` LimitedUserRequest[], required
    - `costRate` integer — Represents cost rate of user. Example: 12300 for 123
    - `hourlyRate` integer — Represents hourly rate of user. Example: 12300 for 123
    - `name` string, required — Represents name of the user.
    - `userCustomFields` UpsertUserCustomFieldRequest[] — Represents a list of upsert user custom field request.
      - `customFieldId` string, required — Represents custom field identifier across the system.
      - `value` object — Represents custom field value.
    - `userGroups` string[] — Represents the user group names of the user
    - `weekStart` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY' — Represents a day of the week.
    - `workCapacity` string — Represents work capacity as a time duration in the ISO-8601 format.
    - `workingDays` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY' — Represents a list of days of the week.

## Response `200`

OK

---

[API](https://skmtc.dev/clockify/apis/clockify-api.md) · [All operations](https://skmtc.dev/clockify/apis/clockify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockify/clockify-api/revisions/a5b636acbcd8/schema)