---
title: "Bulk Team Member Add"
method: POST
path: "/team/bulk_member_add"
tags: ["team management"]
---

# Bulk Team Member Add

`POST /team/bulk_member_add`

Bulk add multiple members to a team at once.

This endpoint reuses the same logic as /team/member_add but provides a bulk-friendly response format.

Parameters:
- team_id: str - The ID of the team to add members to
- members: List[Member] - List of members to add to the team
- all_users: Optional[bool] - Flag to add all users on Proxy to the team
- max_budget_in_team: Optional[float] - Maximum budget allocated to each user within the team

Returns:
- results: List of individual member addition results
- total_requested: Total number of members requested for addition
- successful_additions: Number of successful additions  
- failed_additions: Number of failed additions
- updated_team: The updated team object

Example request:
```bash
curl --location 'http://0.0.0.0:4000/team/bulk_member_add'     --header 'Authorization: Bearer sk-1234'     --header 'Content-Type: application/json'     --data '{
    "team_id": "team-1234",
    "members": [
        {
            "user_id": "user1",
            "role": "user"
        },
        {
            "user_email": "user2@example.com",
            "role": "admin"
        }
    ],
    "max_budget_in_team": 100.0
}'
```

## Request body

- BulkTeamMemberAddRequest — Request for bulk team member addition
  - `team_id` string, required
  - `members` Member[], nullable
    - `user_id` string, nullable — The unique ID of the user to add. Either user_id or user_email must be provided
    - `user_email` string, nullable — The email address of the user to add. Either user_id or user_email must be provided
    - `role` 'admin' | 'user', required — The role of the user within the team. 'admin' users can manage team settings and members, 'user' is a regular team member
  - `all_users` boolean, nullable
  - `max_budget_in_team` number, nullable

## Response `200`

Successful Response

- BulkTeamMemberAddResponse — Response for bulk team member add operations
  - `team_id` string, required
  - `results` TeamMemberAddResult[], required
    - `user_id` string, nullable
    - `user_email` string, nullable
    - `success` boolean, required
    - `error` string, nullable
    - `updated_user` object, nullable
    - `updated_team_membership` object, nullable
  - `total_requested` integer, required
  - `successful_additions` integer, required
  - `failed_additions` integer, required
  - `updated_team` object, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.net/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sea-lion/litellm-api/revisions/79928a3d37d3/schema)