How to Retrieve an Assumed Role Session

Updated on 08 April, 2026

Retrieve details of a specific assumed role session in Vultr IAM. View the session status, associated role, expiry time, and credentials through the IAM API.


Retrieving an assumed role session allows you to check the session details, including its remaining duration, the role being assumed, and the conditions under which it was created. This is useful for monitoring active sessions and verifying session status.

This guide explains how to retrieve an assumed role session using the Vultr API.

Send a GET request to the Read Assumed Role Session endpoint to retrieve the session details. Replace {session-token} with the session token returned when the role was assumed.

console
$ curl "https://api.vultr.com/v2/assumed-roles/{session-token}" \
    -X GET \
    -H "Authorization: Bearer ${VULTR_API_KEY}"

The response contains the resource details.

Comments