List Environments

Prerequisites

Endpoint and authentication are configured. See Overview and authentication.

Endpoint

GET /environments

Query parameters

Parameter	Required	Type	Default	Description
`limit`	No	int	20	Number of items per page, maximum 100
`page`	No	string	—	Omit on the first call; pass `next_page` from the previous response for subsequent calls
`include_archived`	No	bool	false	Whether to include archived environments

Request example

curl "$AGENTSTUDIO_URL/environments?limit=20" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Response example

{
  "data": [
    {
      "id": "env_xxx",
      "type": "environment",
      "name": "data-sandbox",
      "description": "数据分析沙箱",
      "config": {
        "type": "cloud",
        "packages": {"apt": ["ffmpeg"], "pip": ["pandas", "numpy", "matplotlib"]},
        "networking": {"type": "unrestricted"}
      },
      "metadata": {"team": "infra"},
      "scope": "organization",
      "archived_at": null,
      "created_at": "2026-06-16T12:45:34+08:00",
      "updated_at": "2026-06-16T12:45:34+08:00"
    }
  ],
  "next_page": "xxx",
  "request_id": "xxx"
}

The top level of the response contains data (an array of Environment objects), next_page (cursor for the next page), and request_id (unique identifier for this request). Environment object fields are as follows:

Environment object fields

Field	Type	Description
`id`	string	Environment ID, format: `env_<ULID>`
`type`	string	Fixed value `environment`
`name` / `description` / `scope` / `config` / `metadata`	string / object	Basic environment attributes and full runtime configuration (sandbox type, pre-installed dependencies, networking policy)
`archived_at`	string \| null	Archive time; `null` when not archived
`created_at` / `updated_at`	string	Creation / last update time, ISO 8601

​Prerequisites

​Endpoint

​Query parameters

​Request example

​Response example