List my sessions
GET /account/sessions
Lists the signed-in sessions on your account, most recently used
first, so you can spot a device you don’t recognise and end it with
DELETE /account/sessions/{id}.
The session you’re using is marked current: true, but only when
you call this with the session cookie. A session unused for more
than 30 minutes no longer works, but it can still appear here: the
server only tries to remove it when its cookie is next sent.
Sessions an administrator started while impersonating you are listed
too, with nothing marking them as such. The list isn’t paged and
never includes IP addresses. API tokens aren’t sessions and aren’t
listed here; see GET /auth/tokens.
In demo mode (AA_DEMO_MODE), where every visitor shares one
account, you only see the session making the request, and with an
API token you see none.
Authorizations
Section titled “Authorizations ”Responses
Section titled “ Responses ”Your signed-in sessions.
object
One signed-in session. user_agent is the User-Agent header from
the request that started the session, and is left out when there
wasn’t one.
object
When a request last used the session. A session unused for more than 30 minutes stops working.
When the session ends no matter how it’s used. Ordinary sign-ins have no fixed end, so it’s left out; impersonation sessions end 30 minutes after they start.
The IP address the session was started from: the first entry in
X-Forwarded-For when there is one, otherwise the connection’s
address. The client can set that header, and a value that isn’t a
valid address isn’t recorded. Only GET /admin/users/{ref}/sessions
returns it, and only if you have users.pii.read as well as
users.read (system.admin also works). It’s left out otherwise,
and also when no address was recorded, so a missing ip doesn’t
tell you which.
true on the session making this request. Only GET /account/sessions sets it, and only when you call it with the
session cookie; otherwise it’s left out.
Authentication required, missing, or invalid
object
Human-readable error summary
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}