Get Stickers

This endpoint retrieves the Stickers that have been put on a given Twin that are visible to the user sending the request.

Method	Path	Operation*
GET	/twins/{twin}/stickers/	get_stickers

*

In order for a user to perform the "get_stickers" operation, the "get_stickers" 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.
context optional*	string, value is {account}, personal, or system; DEFAULT=personal	query string	You can narrow down the list of Stickers to be included in the search: - {account}: Account UUID of the account where the Sticker was created. - personal: Stickers for which the requesting user is the recipient. - system: Stickers in the entire Trusted Twin system visible to the requesting user.

*

If no context parameter is provided, the default value (context=personal) is used and only Stickers created by the account of the requesting using where he is on the `"recipients" list are returned.

Response

Attribute	Type	Description
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).

The response returns a list of Stickers for the requested Twin grouped by account UUIDs.

Status codes

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