---
title: "Bulk delete records (partial success)"
method: POST
path: "/v2/prism/{teamId}/action/batch/delete"
---

# Bulk delete records (partial success)

`POST /v2/prism/{teamId}/action/batch/delete`

Soft-delete up to 100 records in a single call. Same partial-success contract as batch/update.

## Path parameters

- `teamId` string, uuid, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `ids` string[], required

## Response `200`

Per-item outcomes

- BatchResult — Partial-success bulk operation result. Inspect `results[].status` per item; the operation as a whole returns 200 even if some items failed.
  - `results` object[], required
    - `id` string, nullable, required — Item ID, or null if the input was unparseable.
    - `status` 'ok' | 'error', required
    - `record` PrismObjectResponse — Object returned by reads (get/create/patch/restore). id is always present.
      - `id` string, uuid, required
      - `default` object — Properties keyed by property slug.
      - `list` object
    - `error` object
      - `code` string
      - `message` string
  - `summary` object, required
    - `total` integer, required
    - `succeeded` integer, required
    - `failed` integer, required

## Other responses

- `400` — Request validation failed. Inspect `error.errors` for field-level details.
- `401` — Missing or invalid credentials. API Gateway maps a missing or invalid `x-api-key` to HTTP 401 with this envelope (including `request_id`). A 403 here means the key was accepted but the caller is not permitted.
- `403` — Authenticated but not permitted to perform this action.
- `500` — Unexpected server error. Retry with backoff; report `request_id` if persistent.

## Changes

- **2026-05-20** `fdc16d4f0be0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/micro-so/apis/prism/changes/v2/prism/:teamId/action/batch/delete/post.md)

---

[API](https://skmtc.dev/micro-so/apis/prism.md) · [All operations](https://skmtc.dev/micro-so/apis/prism/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/micro-so/prism/revisions/2b55e7c05657/schema)