Skip to content
MCP Gateway

Preview active sessions and backend sessions affected by a target revocation.

POST
/v1/revocations/preview

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
object
tenant_id
string
environment_id
string
target
required
object
type
required
Allowed values: mcp_server tool agent user client_surface credential_binding connector
id
required
string
>= 1 characters
reason_code
required
string
/^[a-z0-9_]+$/
reason
string
<= 500 characters
correlation_id
string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Affected active sessions and backend sessions; no state transition is applied.

object
schema_version
required
target
required
object
type
required
Allowed values: mcp_server tool agent user client_surface credential_binding connector
id
required
string
>= 1 characters
tenant_id
required
string
environment_id
required
string
affected_active_sessions
required
Array<object>
object
client_session_id
required
string
state
required
string
Allowed values: pending active reconnecting draining terminated revoked expired failed
actor_id
required
string | null
user_id
required
string | null
agent_id
required
string | null
client_surface_id
required
string
backend_session_ids
required
Array<string>
last_seen_at
required
string format: date-time
affected_backend_sessions
required
Array<object>
object
client_session_id
required
string
backend_session_id
required
string
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
blocks_new_calls
required

403

Section titled “403 ”

Caller lacks revocation.preview.

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