For up-to-date product documentation, see the IBM MobileFirst Foundation Developer Center.

Push Device Registration (DELETE)

Deletes(unregisters) an existing device registration from the push service

Description

The device registrations of push service is deleted for the given deviceId. The call returns HTTP response code 204 with no content on successful deletion of the device registration.

Method

DELETE

Path

/apps/applicationId/devices/deviceId

Example

https://example.com:443/imfpush/v1/apps/myapp/devices/12345-6789

Path Parameters

deviceId

The device identifier

applicationId

The name or identifier of the application

Header Parameters

Some header parameters are optional.

Accept-Language

(Optional) The preferred language to use for error messages.. Default:en-US

Authorization

The token with the scope "devices.write" and "push.application.<applicationId>" obtained using the confidential client in the format Bearer token.. This parameter has to be mandatorily set.

Produces

application/json

Errors

401

Unauthorized - The caller is either not authenticated or not authorized to make this request.

404

A device registration with the specified deviceId is not found.

406

Unsupported Accept type - The content type specified in Accept header is not application/json.

500

An internal error occurred.

Parent topic: REST API for the MobileFirst Server push service