Skip to content
MCP Gateway

Read one tenant-scoped environment settings record without switching UI scope.

GET
/v1/environments/{environment_id}

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

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

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Tenant-scoped environment settings detail with safe topology metadata.

object
schemaVersion
required
requestId
required
string
>= 1 characters
currentScope
required
object
tenantId
required
string
>= 1 characters
environmentId
required
string
>= 1 characters
environment
required
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

403

Section titled “403 ”

Actor is authenticated but lacks environment read 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

404

Section titled “404 ”

Environment was not found in the actor tenant, including cross-tenant identifiers.

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.