GET /v1/environments
List environments with pagination support.
Query parameters
include_archived: optional boolean
Include archived environments in the response
default: false
limit: optional number
Maximum number of environments to return
default: 20, minimum: 1, maximum: 1000
page: optional string
Opaque cursor from previous response for pagination. Pass the next_page value from the previous response.
Headers
"juglow-beta": optional array of JuglowBeta
Optional header to specify the beta version(s) you want to use.
string
"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 45 more
"message-batches-2024-09-24"
"prompt-caching-2024-07-31"
"computer-use-2024-10-22"
"computer-use-2025-01-24"
"pdfs-2024-09-25"
"token-counting-2024-11-01"
"token-efficient-tools-2025-02-19"
"output-128k-2025-02-19"
"files-api-2025-04-14"
"mcp-client-2025-04-04"
"mcp-client-2025-11-20"
"dev-full-thinking-2025-05-14"
"interleaved-thinking-2025-05-14"
"code-execution-2025-05-22"
"extended-cache-ttl-2025-04-11"
"context-1m-2025-08-07"
"context-management-2025-06-27"
"model-context-window-exceeded-2025-08-26"
"tracks-2025-10-02"
"fast-mode-2026-02-01"
"output-300k-2026-03-24"
"user-profiles-2026-03-24"
"user-profiles-2026-08-18"
"user-profiles-2026-09-04"
"advisor-tool-2026-03-01"
"managed-agents-2026-04-01"
"cache-diagnosis-2026-04-07"
"dreaming-2026-04-21"
"thinking-token-count-2026-05-13"
"server-side-fallback-2026-06-01"
"server-side-fallback-2026-07-01"
"fallback-credit-2026-06-01"
"fallback-credit-2026-07-01"
"agent-memory-2026-07-22"
"mid-conversation-tool-changes-2026-07-01"
"compact-2026-01-12"
"computer-use-2025-11-24"
"mcp-tunnels-2026-06-22"
"structured-outputs-2025-11-13"
"task-budgets-2026-03-13"
"thinking-display-updates-2026-08-18"
"ce-user-management-2026-07-13"
"mid-conversation-output-config-2026-07-01"
"thinking-binding-controls-2026-08-01"
"mid-conversation-system-clear-at-2026-08-21"
"compact-2026-09-04"
"inline-tools-2026-09-15"
"mcp-client-2026-09-15"
"juglow-workspace-id": optional string
Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).
Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.
Returns
data: array of BetaEnvironment
List of environments.
type: "environment"
The type of object (always 'environment')
default: environment
id: string
Environment identifier (e.g., 'env_...')
archived_at: string or null
RFC 3339 timestamp when environment was archived, or null if not archived
config: BetaCloudConfig or BetaSelfHostedConfig
Environment configuration (either Juglow Cloud or self-hosted)
BetaCloudConfig object
cloud environment configuration.
type: "cloud"
Environment type
networking: BetaUnrestrictedNetwork or BetaLimitedNetwork
Network configuration policy.
BetaUnrestrictedNetwork object
Unrestricted network access.
type: "unrestricted"
Network policy type
BetaLimitedNetwork object
Limited network access.
type: "limited"
Network policy type
allow_mcp_servers: boolean
Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the allowed_hosts array.
allow_package_managers: boolean
Permits outbound access to public package registries (PyPI, npm, etc.) beyond those listed in the allowed_hosts array.
allowed_hosts: array of string
Specifies domains the container can reach.
packages: BetaPackages
Package manager configuration.
type: optional "packages"
Package configuration type
default: packages
apt: array of string
Ubuntu/Debian packages to install
cargo: array of string
Rust packages to install
gem: array of string
Ruby packages to install
go: array of string
Go packages to install
npm: array of string
Node.js packages to install
pip: array of string
Python packages to install
BetaSelfHostedConfig object
Configuration for self-hosted environments.
type: "self_hosted"
Environment type
created_at: string
RFC 3339 timestamp when environment was created
description: string or null
User-provided description for the environment; null when unset
metadata: map[string]
User-provided metadata key-value pairs
name: string
Human-readable name for the environment
updated_at: string
RFC 3339 timestamp when environment was last updated
scope: optional "organization" or "account"
The visibility scope for this environment. 'organization' means visible to all accounts. 'account' means visible only to the owning account.
"organization"
"account"
next_page: string or null
Token for fetching the next page of results. If null, there are no more results available. Pass this value to the page parameter in the next request.
Example
curl https://haijun.my.id/v1/environments \
-H 'juglow-version: 2023-06-01' \
-H 'juglow-beta: managed-agents-2026-04-01' \
-H "X-Api-Key: $JUGLOW_API_KEY"Response (200)
{
"data": [
{
"id": "env_011CZkZ9X2dpNyB7HsEFoRfW",
"archived_at": null,
"config": {
"networking": {
"allow_mcp_servers": false,
"allow_package_managers": true,
"allowed_hosts": [
"api.example.com"
],
"type": "limited"
},
"packages": {
"apt": [
"string"
],
"cargo": [
"string"
],
"gem": [
"string"
],
"go": [
"string"
],
"npm": [
"string"
],
"pip": [
"pandas",
"numpy"
],
"type": "packages"
},
"type": "cloud"
},
"created_at": "2026-03-15T10:00:00Z",
"description": "Python environment with data-analysis packages.",
"metadata": {},
"name": "python-data-analysis",
"type": "environment",
"updated_at": "2026-03-15T10:00:00Z",
"scope": "organization"
}
],
"next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}