---
title: "Bulk Actions"
method: POST
path: "/api/customers/bulk"
tags: ["Customers"]
---

# Bulk Actions

`POST /api/customers/bulk`

## Request

- Base URL: `https://uptimeify.io`
- URL: `https://uptimeify.io/api/customers/bulk`
- Auth: HTTP bearer

POST /api/customers/bulk

## Request body

- object
  - `ids` integer[], required: Customer ids, unique, at most 200.
  - `action` 'reports' | 'activate' | 'deactivate' | 'delete' | 'package', required
  - `payload` object: Required for reports ({ enabled }) and package ({ packageId }); delete takes { userAction }.

## Response `200`

OK

- object: 200 even when some ids fail.
  - `ok` integer[], required
  - `failed` object[], required
    - `id` integer, required
    - `reason` string, required: Error code, e.g. customerNotFound.

## Other responses

- `400`: Invalid or missing parameters.
- `401`: Missing, invalid or expired API token.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api.md) · [All operations](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/revisions/2129a771ee7e?raw)
