Query durable active session metadata.

GET

/v1/sessions

Authorizations

• oidc

Parameters

Query Parameters

tenant_id

string

environment_id

string

state

string

Comma-separated session states. Defaults to active,reconnecting,draining.

client_session_id

string

agent_id

string

user_id

string

client_surface_id

string

server_id

string

credential_binding_id

string

connector_id

string

page

integer

default: 1 >= 1

page_size

integer

default: 50

Allowed values: 50

sort

string

Allowed values: last_seen_at:desc

Responses

200

Paginated active sessions from durable metadata.

object

schema_version

required

page

required

integer

>= 1

page_size

required

integer

Allowed values: 50

total_count

required

integer

kpis

required

object

active_sessions

required

integer

reconnecting_sessions

required

integer

draining_sessions

required

integer

revoked_sessions

required

integer

backend_sessions

required

integer

facets

required

object

state

required

Array<object>

object

value

required

string

count

required

integer

server_id

required

Array<object>

object

value

required

string

count

required

integer

agent_id

required

Array<object>

object

value

required

string

count

required

integer

user_id

required

Array<object>

object

value

required

string

count

required

integer

client_surface_id

required

Array<object>

object

value

required

string

count

required

integer

credential_binding_id

required

Array<object>

object

value

required

string

count

required

integer

connector_id

required

Array<object>

object

value

required

string

count

required

integer

items

required

Array<object>

object

client_session_id

required

string

state

required

string

Allowed values: pending active reconnecting draining terminated revoked expired failed

tenant_id

required

string

environment_id

required

string

actor_id

required

string | null

user_id

required

string | null

agent_id

required

string | null

agent_instance_id

required

string | null

client_surface_id

required

string

server_id

required

string | null

tool_id

required

string | null

credential_mode

required

string

Allowed values: none service_account user_delegated agent_scoped workload_mapped

credential_binding_id

required

string | null

connector_id

required

string | null

backend_session_count

required

integer

worker_id

required

string | null

shard_id

required

string | null

affinity_key

required

string | null

created_at

required

string format: date-time

updated_at

required

string format: date-time

last_seen_at

required

string format: date-time

expires_at

required

string | null format: date-time

revoked_at

required

string | null format: date-time

revocation_id

required

string | null

permissions

required

object

resource_type

required

Allowed values: mcp_server agent credential_binding client_session

resource_id

required

string

>= 1 characters

allowed_actions

required

Array

Allowed values: mcp_server.read mcp_server.register mcp_server.submit_revision mcp_server.resubmit mcp_server.edit_owner mcp_server.validate_manifest mcp_server.reprobe mcp_server.approve_submission mcp_server.reject_submission mcp_server.disable mcp_server.deprecate mcp_server.archive mcp_server.compare_versions agent.read agent.submit agent.edit agent.approve agent.reject agent.disable agent.archive agent.revoke api_source.read api_source.import api_source.review api_source.approve api_source.reject api_source.disable api_source.archive credential_binding.read credential_binding.create credential_binding.update credential_binding.rotate credential_binding.disable credential_binding.revoke credential_binding.approve credential_binding.audit_read identity_provider.read identity_provider.diagnose role_binding.read role_binding.manage local_identity.read local_identity.manage reason_code.read reason_code.manage approval_queue.read approval_queue.batch_approve

403

Caller lacks session.read.