Skip to main content
GET
/
lens
/
sessions
/
metadata
curl https://api.u1.archetypeai.app/v0.5/lens/sessions/metadata \
  -H "Authorization: Bearer $ATAI_API_KEY"

[
  {
    "session_id": "lsn-250313c2177253cbaa7a73542edd90",
    "lens_id": "lns-fd669361822b07e2-237ab3ffd79199b1",
    "last_update_timestamp": 1741843135.1848276,
    "session_status": "SESSION_STATUS_RUNNING",
    "session_runner": "lens_service:runner:lens-node-worker-node-abc123",
    "session_endpoint": "wss://api.u1.archetypeai.app/v0.5/lens/sessions/lsn-250313c2177253cbaa7a73542edd90",
    "session_index": 0,
    "session_duration_sec": 2811.020206451416
  }
]

​
Overview

This endpoint returns detailed information about each active lens session in your organization.

​
Request

​
session_id
string
Optional. Filter to a specific session by ID.
​
shard_index
integer
default:"-1"
Optional. Shard index for pagination. Use -1 to retrieve all sessions.
​
max_items_per_shard
integer
default:"-1"
Optional. Maximum items per shard. Use -1 for no limit.

​
Response

Returns an array of session objects, each containing:
​
session_id
string
Unique identifier for the session
​
lens_id
string
The lens ID associated with this session
​
last_update_timestamp
float
Unix timestamp of the last activity on this session
​
session_status
string
Current status of the session
​
session_endpoint
string
WebSocket endpoint for this session
​
session_duration_sec
float
How long the session has been active in seconds
​
session_runner
string
Identifier of the backend runner hosting the session.
​
session_index
integer
Zero-based index of this session within the runner.
curl https://api.u1.archetypeai.app/v0.5/lens/sessions/metadata \
  -H "Authorization: Bearer $ATAI_API_KEY"

[
  {
    "session_id": "lsn-250313c2177253cbaa7a73542edd90",
    "lens_id": "lns-fd669361822b07e2-237ab3ffd79199b1",
    "last_update_timestamp": 1741843135.1848276,
    "session_status": "SESSION_STATUS_RUNNING",
    "session_runner": "lens_service:runner:lens-node-worker-node-abc123",
    "session_endpoint": "wss://api.u1.archetypeai.app/v0.5/lens/sessions/lsn-250313c2177253cbaa7a73542edd90",
    "session_index": 0,
    "session_duration_sec": 2811.020206451416
  }
]