Remove a Sticker

This endpoint removes a given Sticker from a given Twin.

Please note that in order to remove a Sticker a user needs to be included on the "recipients" list of the given Sticker. If a user created a Sticker and did not include themselves (i.e., the UUID of their user, the UUID of their role, or the UUID of the account their user belong to) on the "recipients" list, they will not be able to remove the Sticker from the given Twin. They will receive the error message "Sticker not found" when trying to remove the Sticker.

Method	Path	Operation*
DELETE	/twins/{twin}/stickers/{color}	remove_sticker

*

In order for a user to perform the "remove_sticker" operation, the "remove_sticker" permission must be included in the list of allowed actions in the statement of the user's role.

Request

Parameter	Type	In	Description
{twin} required	string	path	Twin UUID of the Twin from which the Sticker should be removed.
color required	string	path	User-defined category of the Sticker. Must be unique in the context of an account. Must match the regular expression (opens new window) ^[a-z_][0-9a-z_]{0,127}$.
context optional	string, value is {account}, personal, or system; DEFAULT=personal	query string	Narrows down the list of Stickers to be removed: - {account}: Account UUID of the account where the Stickers were created. - personal: Stickers for which the requesting user is the recipient. - system: Stickers in the entire Trusted Twin system visible to the requesting user.

Response

Attribute	Type	Description
account	string	Account UUID of the account that created the Sticker.
message	string	Message for the recipients of the Sticker. The maximum length of a message is 256 characters.
validity_ts	timestamp	Time at which the Sticker expires. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch (opens new window).
created_ts	timestamp	Time at which the Sticker was created. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch (opens new window).

Status codes

Requests to this endpoint result in generic status codes. For a comprehensive list of status codes, please consult the Status codes section.