List sessions

GET

/api/v1/auth/sessions

curl --request GET \
  --url https://example.com/api/v1/auth/sessions \
  --header 'Authorization: Bearer <token>'

Lists the sessions. It requires a signed-in User with the account scope. It can return 401 if the session is missing or expired, 403 if access is denied and 429 if the request limit is reached. Route: /api/v1/auth/sessions. Inputs: . Safe reads can use bounded retries.

Authorizations

• installationBearer
• browserSession

Responses

200

Media typeapplication/json

Array<object>

object

created_at

required

integer format: int64

current

required

True only for the session that made this request.

boolean

expires_at

required

integer format: int64

id

required

string

installation_name

string | null

kind

required

string

Allowed values: web installation

last_seen_at

required

integer format: int64

resource_scope

One of:

object

One of:

object

object

kind

required

string

Allowed values: home_and_shared

user_id

required

string format: uuid

null

null

revoked

required

boolean

scopes

required

Server-enforced scopes. Agent containers receive DATA; Ask Agent containers also receive READ_ONLY, which the request authority enforces for writes.

integer format: int32

user_id

required

string format: uuid

Example

[
  {
    "kind": "web",
    "resource_scope": {
      "kind": "home_and_shared"
    }
  }
]

429

Media typeapplication/json

object

code

required

string

message

required

string

Example^generated

{
  "code": "example",
  "message": "example"
}