Skip to content
MCP Gateway

Read durable session metadata, backend sessions, transitions, and allowed actions.

GET
/v1/sessions/{client_session_id}

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
client_session_id
required
string

Query Parameters

Section titled “Query Parameters ”
tenant_id
string
environment_id
string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Session detail.

object
schema_version
required
session
required
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
backend_sessions
required
Array<object>
object
backend_session_id
required
string
backend_kind
required
Allowed values: mcp_server api_adapter
state
required
string
Allowed values: opening open closing closed revoked failed
server_id
required
string | null
tool_id
required
string | null
credential_binding_id
required
string | null
connector_id
required
string | null
worker_id
required
string | null
shard_id
required
string | null
affinity_key
required
string | null
supports_resume
required
boolean
created_at
required
string format: date-time
updated_at
required
string format: date-time
last_seen_at
required
string format: date-time
transitions
required
Array<object>
object
transition_id
required
string
event_type
required
Allowed values: session.create session.terminate session.revoke revocation.create
actor_id
required
string
previous_state
required
string
Allowed values: pending active reconnecting draining terminated revoked expired failed
next_state
required
string
Allowed values: pending active reconnecting draining terminated revoked expired failed
reason_code
required
string
/^[a-z0-9_]+$/
reason
required
string | null
<= 500 characters
correlation_id
required
string | null
revocation_id
required
string | null
backend_session_ids
required
Array<string>
occurred_at
required
string format: date-time
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

Section titled “403 ”

Caller lacks session.read.

Type set in Geist, Source Serif 4, and Departure Mono.