Skip to content
MCP Gateway

Read safe connector blast-radius metadata before a lifecycle action.

GET
/v1/connectors/{connector_id}/impact

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
connector_id
required
string
>= 1 characters

Query Parameters

Section titled “Query Parameters ”
tenant_id
required
string
>= 1 characters
environment_id
required
string
>= 1 characters

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Affected MCP servers, affected routes, session count, backend count, and recent denied/failed counts using safe IDs only.

object
schemaVersion
required
connectorId
required
string
>= 1 characters
tenantId
required
string
>= 1 characters
environmentId
required
string
>= 1 characters
affectedMcpServers
required
Array<object>
object
serverId
required
string
>= 1 characters
toolId
required
string
>= 1 characters
backendRef
required
string
/^connector://[^/]+/[^/]+$/
affectedRoutes
required
Array<object>
object
id
required
string
>= 1 characters
href
required
string
/^/operate//
activeSessionsCount
required
integer
backendCount
required
integer
latestDeniedRouteCount
required
integer
latestFailedRouteCount
required
integer
redactionStatus
required
Allowed values: redacted

403

Section titled “403 ”

Caller lacks connector.view_impact.

object
schemaVersion
required
requestId
required
string
>= 1 characters
status
required
integer
>= 400 <= 599
reasonCode
required
string
/^[a-z0-9_]+$/
message
required
string
>= 1 characters
retryable
required
boolean
machineSafe
required
boolean
redactionStatus
required
Allowed values: redacted metadata_only
field

Optional metadata-only field identifier for validation errors.

string
details

Optional metadata-only diagnostic details. Never include secret material, payloads, prompts, raw endpoint URLs, or customer data.

object
requiredAction
string
>= 1 characters
resourceRef
string
>= 1 characters
key
additional properties
One of:
string

404

Section titled “404 ”

Connector not found in the requested tenant and environment scope.

object
schemaVersion
required
requestId
required
string
>= 1 characters
status
required
integer
>= 400 <= 599
reasonCode
required
string
/^[a-z0-9_]+$/
message
required
string
>= 1 characters
retryable
required
boolean
machineSafe
required
boolean
redactionStatus
required
Allowed values: redacted metadata_only
field

Optional metadata-only field identifier for validation errors.

string
details

Optional metadata-only diagnostic details. Never include secret material, payloads, prompts, raw endpoint URLs, or customer data.

object
requiredAction
string
>= 1 characters
resourceRef
string
>= 1 characters
key
additional properties
One of:
string

500

Section titled “500 ”

Connector repository is unavailable.

object
schemaVersion
required
requestId
required
string
>= 1 characters
status
required
integer
>= 400 <= 599
reasonCode
required
string
/^[a-z0-9_]+$/
message
required
string
>= 1 characters
retryable
required
boolean
machineSafe
required
boolean
redactionStatus
required
Allowed values: redacted metadata_only
field

Optional metadata-only field identifier for validation errors.

string
details

Optional metadata-only diagnostic details. Never include secret material, payloads, prompts, raw endpoint URLs, or customer data.

object
requiredAction
string
>= 1 characters
resourceRef
string
>= 1 characters
key
additional properties
One of:
string

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