Get User Secret

This endpoint retrieves the details of the User Secret for a given user.

Method	Path	Operation*
GET	/users/{user}/secrets	get_user_secret

*

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

Request

Parameter	Type	In	Description
{user} required	string	path	User UUID of the User for whom the User Secret was created.

In our example, we retrieve the details of the User Secret created for the user with the user UUID "333b4bf7-43b6-4df1-927a-9ddbd7336144".

Response

Attribute	Type	Description
fingerprint	string	4 last characters of the User Secret.
account	string	Account UUID.
user	string	User UUID of the user for whom the User Secret was created.
validity_ts	timestamp	Time at which the User Secret expires. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch(opens new window). If the value is null, the User Secret does not expire.
created_ts	timestamp	Time at which the User Secret was created. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch(opens new window).
updated_ts	timestamp	Time at which the User Secret was last updated. 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.