Remove action

Allows users to remove their previously-posted message actions, by specifying the parent message, and the single timetoken of the action(s) they wish to delete. It is technically possible to delete more than one action if the same UUID/userId posted different actions on the same parent message at the same time. If all goes well, the action(s) are deleted from the database, and one or more Action remove event messages are published on the same channel as the parent message.

Path Parameters
sub_key string REQUIRED

Your app's subscribe key from Admin Portal.

Example: sub-c-50264475-1902-558x-d213-7p19052012n2

channel string REQUIRED

The channel name to perform the operation on.

Example: myChannel

message_timetoken string REQUIRED

The publish timetoken of a parent message.

Example: 15610547826970040

action_timetoken string REQUIRED

The publish timetoken of the action.

Example: 15610547826970040

Query Parameters
auth string

String which is either the auth key (PAM v2) or a valid token (Access Manager) used to authorize the operation if access control is enabled.

Example: myAuth / p0thisAkFl043rhDdHRsCkNyZXisRGNoYW6hanNlY3JldAFDZ3Jwsample3KgQ3NwY6BDcGF0pERjaGFuoENnctokenVzcqBDc3BjoERtZXRhoENzaWdYIGOAeTyWGJI

uuid string REQUIRED

A UTF-8 encoded string of up to 92 characters used to identify the client.

Example: myUniqueUserId

signature string

Signature used to verify that the request was signed with the secret key associated with the subscribe key.

If Access Manager is enabled, either a valid authorization token or a signature are required.

Check Access Manager documentation for details on how to compute the signature.

timestamp integer

Unix epoch timestamp used as a nonce for signature computation. Must have no more than ± 60 seconds offset from NTP.

Required if the signature parameter is supplied.

Responses
200

The action was removed.

Schema OPTIONAL
status integer OPTIONAL
data object OPTIONAL
207

The action was deleted but the action-deletion message was not published.

Schema OPTIONAL
status integer OPTIONAL
error object OPTIONAL
message string OPTIONAL
source string OPTIONAL
400

Wrong uuid specified for the given message action.

Schema OPTIONAL
status integer OPTIONAL
error object OPTIONAL
message string OPTIONAL
source string OPTIONAL
403

The client isn't authorized to perform this operation.

Schema OPTIONAL
status integer OPTIONAL
error object OPTIONAL
source string OPTIONAL
message string OPTIONAL