---
title: "Add Users to Team"
method: POST
path: "/v1/teams/{id}/users/add"
tags: ["Teams"]
---

# Add Users to Team

`POST /v1/teams/{id}/users/add`

Adds users to a specified team with assigned roles. With user permissions, the team must be one the requesting user has edit access to. With admin permissions, users can be added to any team belonging to the account.

## Path parameters

- `id` number, required

## Headers

- `Lucid-Request-As` string

## Request body

- AddUsersToTeamBody
  - `users` TeamUser[], required — Array of users with their assigned roles to add to the team
    - `userId` integer, required — The ID of the user to add to the team
    - `role` 'TEAM_MANAGER' | 'EDIT_SHARE_MEMBER' | 'EDIT_MEMBER' | 'COMMENT_MEMBER' | 'VIEW_MEMBER', required — The role to assign to a user on a team. Team roles determine what permissions a user has on documents shared with the team: - `TEAM_MANAGER`: Can manage team settings, members, and has full access to team content - `EDIT_SHARE_MEMBER`: Can view, comment on, edit, and share team documents - `EDIT_MEMBER`: Can view, comment on, and edit team documents - `COMMENT_MEMBER`: Can view and comment on team documents - `VIEW_MEMBER`: Can only view team documents

## Response `204`

No Content. The users were successfully added to the team with their assigned roles. If requesting as admin, users may have been added even though the authenticated user does not have direct access to the specified team.

## Other responses

- `403` — Forbidden. * if not all the specified users are on the authenticated account. * if the user making the request does not have permission to edit teams. * if the user making the request does not have access to the specified team. * if the team is managed via SCIM. Use the SCIM Groups API to modify SCIM-managed teams.

---

[API](https://skmtc.net/lucid/apis/lucid-rest-api.md) · [All operations](https://skmtc.net/lucid/apis/lucid-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lucid/lucid-rest-api/versions/6a32cb9e1aa7/schema)