---
title: "Delete multiple messages from inbox"
method: POST
path: "/api/user/messages/batch-delete"
tags: ["Push"]
---

# Delete multiple messages from inbox

`POST /api/user/messages/batch-delete`

## Request

- Base URL: `https://go.urbanairship.com`
- URL: `https://go.urbanairship.com/api/user/messages/batch-delete`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/airship/apis/airship-api/docs/api/user/messages/batch-delete/post.ts> (a function with typed inputs; its response is checked against the schema)

Deletes multiple Message Center messages completely, removing them from every user's inbox. You can provide up to 50 IDs in a request. This is an asynchronous call. A success response means that the deletion has been queued for processing.

When providing a group ID, only messages delivered by the time this request is made will be deleted. Messages that are delivered after this request, such as by an ongoing automation, will continue to be available.

## Request body

- union
  - object
    - `message_ids` string[], required: Array of `message_id` or `push_id` values.
  - object
    - `group_ids` string[], required: Array of `group_id` values.

## Response `202`

The deletion request has been accepted for processing.

- object
  - `deleted_message_ids` string[], required: Message IDs queued for deletion. Populated when the request uses `message_ids`. Always an empty array when the request uses `group_ids`.
  - `errors` object[], required: Errors for individual message IDs in the request. An empty array when all IDs were accepted. Always an empty array when the request uses `group_ids`.
    - `error_code` integer, required
    - `error_message` string, required
    - `message_id` string, required

## Other responses

- `404`: The requested resource doesn't exist.

---

[API](https://skmtc.dev/airship/apis/airship-api.md) - [All operations](https://skmtc.dev/airship/apis/airship-api/llms.txt) - [OpenAPI document](https://skmtc.dev/airship/apis/airship-api/revisions/bd6ab947117a?raw)