---
title: "Batch delete identities."
method: POST
path: "/v1/tenants/{tenant_id}/realms/{realm_id}/identities:batchDelete"
tags: ["Identities"]
---

# Batch delete identities.

`POST /v1/tenants/{tenant_id}/realms/{realm_id}/identities:batchDelete`

## Request

- Base URL: `https://api-us.beyondidentity.com`
- URL: `https://api-us.beyondidentity.com/v1/tenants/{tenant_id}/realms/{realm_id}/identities:batchDelete`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-access-api/docs/v1/tenants/:tenant_id/realms/:realm_id/identities:batchDelete/post.ts> (a function with typed inputs; its response is checked against the schema)

To delete multiple identities in a realm, send a POST request to `/v1/tenants/$TENANT_ID/realms/$REALM_ID/identities:batchDelete`.
The request must contain at least one and no more than 1000 identity IDs. If there are any repeating identity IDs, the request will fail. If there are any invalid identity IDs, the request will fail and no identities will be deleted.
A successful request will receive a 200 status code with no body in the response. This indicates that the request was processed successfully.

## Path parameters

- `tenant_id` string, required
- `realm_id` string, required

## Request body

- object: Request for BatchDeleteIdentities.
  - `ids` string[], required: IDs of the identities to be deleted.

## Response `200`

The action was successful and the response body is empty.

## Other responses

- `401`: Unauthorized.
- `403`: Forbidden.
- `404`: The resource was not found.
- `500`: Server error.

## Changes

- **2026-11-06** `42f3cac49392`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-access-api/changes/v1/tenants/:tenant_id/realms/:realm_id/identities:batchDelete/post.md)

---

[API](https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-access-api.md) - [All operations](https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-access-api/llms.txt) - [OpenAPI document](https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-access-api/revisions/42f3cac49392?raw)