Application Sessions
Get Application Session
Get an application session by ID.
Request
GET /app/sessions/{id}
Response
Returns a 200 response on success
Fields
Name | Type | Description |
---|
id | string | unique application session resource identifier |
uri | string | URI of the application session API resource |
public_url | string | URL of the hostport served by this endpoint |
browser_session | BrowserSession | browser session details of the application session |
application_user | Ref | application user this session is associated with |
created_at | string | timestamp when the user was created in RFC 3339 format |
last_active | string | timestamp when the user was last active in RFC 3339 format |
expires_at | string | timestamp when session expires in RFC 3339 format |
endpoint | Ref | ephemeral endpoint this session is associated with |
edge | Ref | edge this session is associated with, null if the endpoint is agent-initiated |
route | Ref | route this session is associated with, null if the endpoint is agent-initiated |
BrowserSession fields
Name | Type | Description |
---|
user_agent | UserAgent | HTTP User-Agent data |
ip_address | string | IP address |
location | Location | IP geolocation data |
UserAgent fields
Name | Type | Description |
---|
raw | string | raw User-Agent request header |
browser_name | string | browser name (e.g. Chrome) |
browser_version | string | browser version (e.g. 102) |
device_type | string | type of device (e.g. Desktop) |
os_name | string | operating system name (e.g. MacOS) |
os_version | string | operating system version (e.g. 10.15.7) |
Location fields
Name | Type | Description |
---|
country_code | string | ISO country code |
latitude | float64 | geographical latitude |
longitude | float64 | geographical longitude |
lat_long_radius_km | uint64 | accuracy radius of the geographical coordinates |
Ref fields
Name | Type | Description |
---|
id | string | a resource identifier |
uri | string | a uri for locating a resource |
Delete Application Session
Delete an application session by ID.
Request
DELETE /app/sessions/{id}
Response
Returns a 204 response with no body on success
List Application Sessions
List all application sessions for this account.
Request
GET /app/sessions
Response
Returns a 200 response on success
Fields
Name | Type | Description |
---|
application_sessions | ApplicationSession | list of all application sessions on this account |
uri | string | URI of the application session list API resource |
next_page_uri | string | URI of the next page, or null if there is no next page |
ApplicationSession fields
Name | Type | Description |
---|
id | string | unique application session resource identifier |
uri | string | URI of the application session API resource |
public_url | string | URL of the hostport served by this endpoint |
browser_session | BrowserSession | browser session details of the application session |
application_user | Ref | application user this session is associated with |
created_at | string | timestamp when the user was created in RFC 3339 format |
last_active | string | timestamp when the user was last active in RFC 3339 format |
expires_at | string | timestamp when session expires in RFC 3339 format |
endpoint | Ref | ephemeral endpoint this session is associated with |
edge | Ref | edge this session is associated with, null if the endpoint is agent-initiated |
route | Ref | route this session is associated with, null if the endpoint is agent-initiated |
BrowserSession fields
Name | Type | Description |
---|
user_agent | UserAgent | HTTP User-Agent data |
ip_address | string | IP address |
location | Location | IP geolocation data |
UserAgent fields
Name | Type | Description |
---|
raw | string | raw User-Agent request header |
browser_name | string | browser name (e.g. Chrome) |
browser_version | string | browser version (e.g. 102) |
device_type | string | type of device (e.g. Desktop) |
os_name | string | operating system name (e.g. MacOS) |
os_version | string | operating system version (e.g. 10.15.7) |
Location fields
Name | Type | Description |
---|
country_code | string | ISO country code |
latitude | float64 | geographical latitude |
longitude | float64 | geographical longitude |
lat_long_radius_km | uint64 | accuracy radius of the geographical coordinates |
Ref fields
Name | Type | Description |
---|
id | string | a resource identifier |
uri | string | a uri for locating a resource |