Skip to content
MCP Gateway

List connector registry read-model rows for the UI with safe health, route, lifecycle, KPI, and permission metadata.

GET
/v1/connectors

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
tenant_id
required
string
>= 1 characters
environment_id
string
>= 1 characters
lifecycle_state
Allowed values: submitted under_review active disabled revoked archived
health_status
Allowed values: healthy degraded unhealthy unknown
region
string
>= 1 characters
owner_team
string
>= 1 characters
min_connected_backends
integer
max_latency_ms
integer
revocation_status
Allowed values: none disabled revoked
sort
default: connector_id
Allowed values: connector_id health_status latency_ms last_heartbeat_at
limit
integer
default: 50 >= 1 <= 100
cursor
string
>= 1 characters

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Paginated connector registry rows with metadata-only facets, KPIs, and row permissions.

object
schemaVersion
required
items
required
Array<object>
object
connectorId
required
string
>= 1 characters
tenantId
required
string
>= 1 characters
environmentId
required
string
>= 1 characters
lifecycleState
required
Allowed values: submitted under_review active disabled revoked archived
approvalStatus
required
string
Allowed values: submitted under_review approved rejected disabled archived
healthStatus
required
Allowed values: healthy degraded unhealthy unknown
routeAvailable
required
boolean
routeAvailabilityReason
required
string
/^[a-z0-9_]+$/
owner
required
object
team
required
string
>= 1 characters
userId
required
string
>= 1 characters
escalationContact
required
string
>= 1 characters
region
required
string
>= 1 characters
deploymentLocation
required
string
>= 1 characters
connectedBackendCount
required
integer
connectedMcpServerCount
required
integer
connectedApiSourceCount
required
integer
lastHeartbeatAt
required
string format: date-time
latencyMs
required
integer
revocationStatus
required
Allowed values: none disabled revoked
revocationReasonCode
string
/^[a-z0-9_]+$/
version
required
string
>= 1 characters
etag
required
string
>= 1 characters
permissions
required
object
allowedActions
required
Array
Allowed values: connector.view connector.view_impact connector.disable connector.reenable connector.revoke connector.archive
pagination
required
object
limit
required
integer
>= 1 <= 100
nextCursor
string
total
required
integer
facets
required
object
lifecycleStates
required
Array<object>
object
value
required
string
>= 1 characters
count
required
integer
healthStatuses
required
Array<object>
object
value
required
string
>= 1 characters
count
required
integer
regions
required
Array<object>
object
value
required
string
>= 1 characters
count
required
integer
revocationStatuses
required
Array<object>
object
value
required
string
>= 1 characters
count
required
integer
kpis
required
object
totalConnectors
required
integer
routeAvailableCount
required
integer
degradedCount
required
integer
disabledCount
required
integer
revokedCount
required
integer
connectedBackendCount
required
integer
averageLatencyMs
required
integer

403

Section titled “403 ”

Caller lacks tenant or environment permission for connector registry rows.

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

422

Section titled “422 ”

Invalid connector list filter, pagination cursor, or sort key.

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.