For Custom Plan subscriptions only. For more details, please contact our Sales team.
Example
{"request": {"auth":"yxoPUlwqm…………pIyEX4H",// required, API access token from Pushwoosh Control Panel"tag": {"name":"TAG_NAME",// required"type":1,// required, see possible values below "application_specific":true,// or 'false', optional. Defines whether the tag value should be different for multiple apps or be the same across multiple apps"user_specific":true// or 'false', optional, used for application_specific tags } }}
Completely removes a tag with all the associated information from the database.
For Custom Plan subscriptions only. For more details, please contact our Sales team.
Example
{"request": {"auth":"yxoPUlwqm…………pIyEX4H",// required, API access token from Pushwoosh Control Panel"tag": {"name":"TAG_NAME"// required, name of a tag to delete } }}
Retrieves a list of tags with corresponding values for the specific device.
Example
{"request":{"application":"XXXXX-XXXXX",// required, Pushwoosh application code"hwid":"HWID",// optional, hardware device ID used in /registerDevice function call"userId":"The ID of a specific user"// optional, can be used instead of "hwid" to retrieve tags for a specific user }}
{ request_id :"request_id to use in GET method to obtain job status","status" : "Pending"}
{"message": "invalid request"}
Sets tag values for the list of devices.
Request:
{"application" : "application code",// required, Pushwoosh app code"auth" : "Pushwoosh auth token",// required, API access token from Pushwoosh Control Panel"create_missing_tags" : false,// optional, should automatically create missing tags"devices" : [{ // required, array of devices"hwid":"device hwid",// optional, can be used to identify a device instead of "user_id" or "push_token"."user_id":"user ID",// optional, can be used to identify a user instead of "hwid" or "push_token"."push_token":"device push token",// optional, can be used to identify a device instead of "hwid" or "user_id"."list_operator":"set",// required for list tags. Defines how to set values for tags of the list type: set, append, or remove"tags": { // required. Values to set for the tags specified. "tag_name":"tagvalue",// use correct value type"tag_name2":"tagvalue2" } }]}
Response:
{"request_id" : "request_id to use in GET method to obtain job status","status" : "Pending"}
{"request_id":"id of the request","status":"Completed",// also "Pending", "Failed""progress":100,// jobs progress 0-100"devices_success":100,// good devices"devices_not_found":0,// devices not found in Pushwoosh"devices_failed":0,// errored"devices": [ // device report (only in detailed = true) {"hwid":"device hwid","status":"done",// also "failed", "not found""tags": {"tagName":"ok","tagName2":"tag not found","tagName3":"wrong value. expect :string", } } ]}