---
title: "Delete message from inbox"
method: DELETE
path: "/api/user/messages/{push_id}"
tags: ["Push"]
---

# Delete message from inbox

`DELETE /api/user/messages/{push_id}`

## Request

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

Delete a Message Center message completely, removing it from every user's inbox. This is an asynchronous call. A success response means that the deletion has been queued for processing.

This delete call will work with either the `message_id` or the `push_id` of the accompanying push notification.

This endpoint will not work with a group ID from an automated message or a push to local time delivery. To delete a Message Center message that was part of an automated or local time delivery, you can provide a group ID to the  [batch-delete](/developer/rest-api/ua/operations/push/#batchdeletemessages) endpoint.

## Path parameters

- `push_id` string, required

## Response `202`

The request has been accepted for processing.

- OkResponseObject: Returned with 2xx Responses. At a minimum, successful calls return `true` for the `ok` key. If your call includes a verbose response (as with `GET` requests, etc.), the `ok` key will appear in the top-most object, outside the verbose response.
  - `ok` boolean, required: Success.
  - `operation_id` string, uuid: A unique string identifying the operations that modify resources. Use the operation ID to locate and track grouped operations (i.e., a batch push operation may generate multiple `push_id` strings, but a single `operation_id`) or operations that change an existing resource.

## 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)