List the caller's active device and web sessions.

GET

/v1/auth/sessions

const url = 'https://api.share2.us/v1/auth/sessions';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

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

Requires an INTERACTIVE login: a personal API token is refused with 403 session_required. The listing carries each machine’s name, fingerprint and last address, and revocation can lock the owner out of their own devices, so a CI token must not reach either. Firebase browser requests need a valid X-Session-Id; the scoped X-Session-Manage-Token issued by web-session registration when the session cap is reached is also accepted, and is itself refused for a suspended or pending-deletion account.

Authorizations

Parameters

Header Parameters

X-Session-Manage-Token

string

Short-lived scoped token accepted only by session list/revoke routes.

Responses

200

Sessions for the authenticated account.

application/json

object

sessions

required

Array<object>

object

required

string format: uuid

device_name

required

string

client_info

string

machine_id

Short display fingerprint, not the raw machine id.

string

created_at

required

string format: date-time

last_used_at

string format: date-time

expires_at

required

string format: date-time

revoked_at

string format: date-time

created_ip

string

last_ip

string

last_country

string

client_type

required

string

Allowed values: cli web

public_key

string

current

required

boolean

Example

{
  "sessions": [
    {
      "client_type": "cli"
    }
  ]
}

401

Missing browser session (session_required) or invalid scoped token.

default

Standard error envelope.

application/json

object

error

required

object

code

required

string

message

required

string

request_id

required

string

Example

{
  "error": {
    "code": "quota_exceeded"
  }
}