---
title: "Delete a push device"
method: DELETE
path: "/service_agents/push_devices/{id}"
tags: ["Service Agent"]
---

# Delete a push device

`DELETE /service_agents/push_devices/{id}`

## Request

- Base URL: `https://api.voipbin.net/v1.0`
- URL: `https://api.voipbin.net/v1.0/service_agents/push_devices/{id}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/voipbin/apis/voipbin-api/docs/service_agents/push_devices/:id/delete.ts> (a function with typed inputs; its response is checked against the schema)

Deletes a push device of the calling agent and returns the deleted device. A device that does
not exist, or that belongs to another agent or another customer, is reported identically as
`404 DEVICE_NOT_FOUND`.

## Path parameters

- `id` string, uuid, required

## Response `200`

The deleted device.

- PushManagerDevice: A push device of the calling agent: one installed app that can receive notifications. The push token is never returned.
  - `id` string, uuid: The device ID returned from POST /service_agents/push_devices.
  - `customer_id` string, uuid: The customer ID of the owner agent, returned from GET /service_agents/me.
  - `agent_id` string, uuid: The owner agent ID, returned from GET /service_agents/me.
  - `platform` 'android': The platform of the push device. Only `android` is supported.
  - `tm_create` string, date-time: When the device was first registered.
  - `tm_update` string, date-time: When the device was last registered or refreshed.

## Other responses

- `400`: Invalid request (INVALID_ARGUMENT).
- `401`: Authentication required (UNAUTHENTICATED).
- `403`: Insufficient permission (PERMISSION_DENIED).
- `404`: Resource not found (NOT_FOUND).
- `500`: Internal error (INTERNAL).

## Changes

- **2026-11-09** `dc2b59b1d86c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/voipbin/apis/voipbin-api/changes/service_agents/push_devices/:id/delete.md)

---

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