Ably Docs

Unregister matching devices for push notifications

DELETE /push/deviceRegistrations

Unregisters devices. All their subscriptions for receiving push notifications through channels will also be deleted.

Query parameters

  • deviceId string

    Optional filter to restrict to devices associated with that deviceId. Cannot be used with clientId.

  • clientId string

    Optional filter to restrict to devices associated with that clientId. Cannot be used with deviceId.

Responses

  • 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.
  • 2XX

    OK

DELETE /push/deviceRegistrations 
curl \
 -X DELETE https://rest.ably.io/push/deviceRegistrations
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"
}