Skip to content
MCP Gateway

Explicitly terminate a client session and fail closed for future calls.

POST
/v1/sessions/{client_session_id}/terminate

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

Request Body required

Section titled “Request Body required ”
object
reason_code
required
string
/^[a-z0-9_]+$/
reason
string
<= 500 characters
correlation_id
string

Responses

Section titled “ Responses ”

202

Section titled “202 ”

Termination accepted and audited.

object
schema_version
required
accepted
required
boolean
client_session_id
required
string
action
required
Allowed values: terminate revoke
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>
audit_event_ids
required
Array<string>
upstream_attempted
required

403

Section titled “403 ”

Caller lacks session.terminate.

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