Service Agent

Delete a push device

Changed on

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.

delete/service_agents/push_devices/{id}

Request

Path parameters

idstring uuid required
Example:3f6c1d2e-8a4b-4c7d-9e10-5b2a7c8d9e01

The device ID returned from POST /service_agents/push_devices.

Response

The deleted device.

idstring uuid

The device ID returned from POST /service_agents/push_devices.

customer_idstring uuid

The customer ID of the owner agent, returned from GET /service_agents/me.

agent_idstring uuid

The owner agent ID, returned from GET /service_agents/me.

platform'android'

The platform of the push device. Only android is supported.

tm_createstring date-time

When the device was first registered.

tm_updatestring date-time

When the device was last registered or refreshed.

Example response

{
  "id": "3f6c1d2e-8a4b-4c7d-9e10-5b2a7c8d9e01",
  "customer_id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
  "agent_id": "2ddf1c90-bbc1-11ef-b991-1bd6ee52cbc5",
  "platform": "android",
  "tm_create": "2026-11-09T09:15:30.123456Z",
  "tm_update": "2026-11-09T09:15:30.123456Z"
}

Changes