---
title: "Delete"
method: POST
path: "/v1/action/delete"
tags: ["Actions"]
---

# Delete

`POST /v1/action/delete`

Deletes one or more objects of the same type. You can specify different types in different delete calls, but each delete call must apply only to one type of object.

The following information applies to this call:

* You will need to first determine the IDs for the objects you wish to delete.
* You cannot pass in any null IDs.
* All objects in a specific delete call must be of the same type.


### Objects per Call
50 objects are supported in a single call.

## Query parameters

- `rejectUnknownFields` boolean

## Headers

- `Idempotency-Key` string
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Track-Id` string
- `X-Zuora-WSDL-Version` string
- `Zuora-Version` string

## Request body

- ProxyActiondeleteRequest
  - `ids` string[], required — A list of one or more IDs for the objects you want to delete.
  - `type` string, required — The type of object that you are deleting.

## Response `200`

OK

- DeleteResult[]
  - `errors` ActionsErrorResponse[] — If the delete failed, this contains an array of Error objects.
    - `Code` string
    - `Message` string
  - `id` string — ID of the deleted object.
  - `success` boolean — A boolean field indicating the success of the delete operation. If the delete was successful, it is `true`. Otherwise, `false`.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)