Unregister a single device for push notifications

DELETE /push/deviceRegistrations/{device_id}

Unregisters a single device by its device ID. All its subscriptions for receiving push notifications through channels will also be deleted.

Path parameters

  • device_id string Required

    Device's ID.

Responses

  • 2XX

    OK

  • default

    Error

    Hide headers attributes Show headers attributes
    • x-ably-errorcode integer

      The error code.

    • x-ably-errormessage string

      The error message.

    • x-ably-serverid string Required

      The ID for the server communicated with.

    Hide response attributes Show response attributes object
    • message string

      Message explaining the error's cause.

    • code integer

      Error code.

    • statusCode integer

      Status error code.

    • href string

      Link to help with error.

    • serverId string

      Server ID with which error was encountered.

DELETE /push/deviceRegistrations/{device_id}
curl \
 -X DELETE https://rest.ably.io/push/deviceRegistrations/{device_id}
Response examples (default)
# Headers
x-ably-errorcode: 42
x-ably-errormessage: string
x-ably-serverid: string

# Payload
{
  "message": "string",
  "code": 42,
  "statusCode": 42,
  "href": "string",
  "serverId": "string"
}
Response examples (default)
# Headers
x-ably-errorcode: 42
x-ably-errormessage: string
x-ably-serverid: string

# Payload
{
  "message": "string",
  "code": 42,
  "statusCode": 42,
  "href": "string",
  "serverId": "string"
}