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