Skip to content
MCP Gateway

List tenant environments for settings/topology awareness without changing current scope.

GET
/v1/environments

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
deployment_mode
string
Allowed values: self_hosted hybrid
health_status
string
Allowed values: healthy degraded unhealthy unknown
is_default
boolean
sort
Allowed values: display_name environment_id updated_at_desc
page_size
integer
default: 100 >= 1 <= 200
page_token
string
>= 1 characters

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Tenant-scoped environment settings list with current-scope summary and safe topology metadata.

object
schemaVersion
required
requestId
required
string
>= 1 characters
currentScope
required
object
tenantId
required
string
>= 1 characters
environmentId
required
string
>= 1 characters
defaultEnvironmentId
string
>= 1 characters
items
required
Array<object>
object
environmentId
required
string
>= 1 characters
displayName
required
string
>= 1 characters
deploymentMode
required
string
Allowed values: self_hosted hybrid
isDefault
required
boolean
isCurrentScope
required
boolean
health
required
object
status
required
string
Allowed values: healthy degraded unhealthy unknown
availability
required
string
Allowed values: available degraded unavailable unknown
routeAvailable
required
boolean
reasonCode
required
string
/^[a-z0-9_]+$/
checkedAt
required
string format: date-time
policyActiveVersion
required
string
>= 1 characters
counts
required
object
mcpServerCount
required
integer
apiSourceCount
required
integer
agentCount
required
integer
credentialBindingCount
required
integer
connectorCount
required
integer
activeSessionCount
required
integer
telemetry
required
object
telemetryMode
required
Allowed values: disabled customer_local managed_metadata_only
auditExportMode
required
Allowed values: disabled customer_siem customer_webhook local_file
siemExportEnabled
required
boolean
customerControlled
required
boolean
redactionStatus
required
Allowed values: redacted disabled
metadata
required
object
createdAt
required
string format: date-time
createdBy
required
string
>= 1 characters
updatedAt
required
string format: date-time
updatedBy
required
string
>= 1 characters
permissions
required
object
allowedActions
required
Array
Allowed values: environments:list environments:read
pagination
required
object
pageSize
required
integer
>= 1 <= 200
totalCount
required
integer
nextPageToken
string
>= 1 characters
permissions
required
object
allowedActions
required
Array
Allowed values: environments:list environments:read

403

Section titled “403 ”

Actor is authenticated but lacks environment list permission for the tenant 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

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