---
title: "Bulk sum/sub to data limit of users"
method: POST
path: "/api/users/bulk/data_limit"
tags: ["User"]
---

# Bulk sum/sub to data limit of users

`POST /api/users/bulk/data_limit`

Bulk modify users' data limit based on the provided criteria.

- **amount**: amount to adjust the user's quota (positive to increase, negative to decrease) required
- **user_ids**: Optional list of user IDs to modify
- **admins**: Optional list of admin IDs — their users will be targeted
- **status**: Optional status to filter users (e.g., "expired", "active"), Empty means no filtering
- **group_ids**: Optional list of group IDs to filter users by their group membership
- **expire_after**: Optional UTC datetime to filter users whose expire date is on or after this date
- **expire_before**: Optional UTC datetime to filter users whose expire date is on or before this date

## Request body

- BulkUser
  - `dry_run` boolean
  - `group_ids` integer[]
  - `admins` integer[]
  - `users` integer[]
  - `status` UserStatus[]
  - `expire_after` string, date-time, nullable
  - `expire_before` string, date-time, nullable
  - `amount` integer, required

## Response `200`

Success confirmation

- unknown

## Other responses

- `401` — Unauthorized Error
- `422` — Validation Error

---

[API](https://skmtc.dev/socialser/apis/pasarguardapi.md) · [All operations](https://skmtc.dev/socialser/apis/pasarguardapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/socialser/pasarguardapi/revisions/4b082bbcb6c3/schema)