# Alibaba Cloud Agent Sandbox API

> Alibaba Cloud Agent Sandbox API on Apizie: 30 endpoints (Creates an API key, Creates a team, Creates a template, Creates a template cache, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-sandbox`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/sandbox
- Page: https://zieapi.vercel.app/api/cloud/aliyun-sandbox
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-sandbox/openapi.json

Alibaba Cloud OpenAPI for Agent Sandbox (sandbox, version 2026-08-20). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Creates an API key
`POST https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/create-api-key` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| apiKeyName | string | no | The name of the API key. The name can be up to 128 characters in length and can contain only letters, digits, spaces, hyphens (-),… |
| expireTime | string | no | The expiration time of the API key. The time is in UTC and follows the RFC 3339 format. If this parameter is left empty, the API key never… |
| ipBlacklist | array | no | The IP address blacklist. If this parameter is configured, the IP addresses in the list cannot use the API key. This parameter is mutually… |
| ipWhitelist | array | no | The IP address whitelist. If this parameter is configured, only the IP addresses in the list can use the API key. This parameter is… |
| teamID | string | no | The ID of the team to which the API key belongs. The ID is in UUID format. If this parameter is not specified, the default team of the… |

### Creates a team
`POST https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/create-team` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| description | string | no | The description of the team |
| plan | string | no | The plan specification of the team. Valid values: eco (economy), std (standard), pro (professional), ent (enterprise) |
| resourceGroupID | string | no | The ID of the Alibaba Cloud resource group to which the team belongs. If this parameter is not specified, the default resource group of… |
| teamName | string | no | The name of the team |

### Creates a template
`POST https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/create-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| buildConfig | object | no | The build configuration of the template. The build process is specified in blocks by action. If this parameter is not specified, the… |
| name | string | no | The template name, which must be unique within the same team |
| runtimeConfig | object | no | The runtime configuration of the template. This configuration determines the specifications and environment of sandbox instances created… |
| teamID | string | no | The ID of the team to which the template belongs, in UUID format. If this parameter is not specified, the default team of the current… |

### Creates a template cache
`POST https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/create-template-cache` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| teamID | string | no | The team ID |
| templateID | string | no | The unique identifier of the template |

### Creates a storage volume
`POST https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/create-volume` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| agenticBucketVolumeConfig | object | no | The AgenticBucket Volume configuration |
| agenticFSVolumeConfig | object | no | The AgenticFS Volume configuration |
| juiceFSVolumeConfig | object | no | The JuiceFS Volume configuration |
| mountConfig | object | no | The mount configuration |
| ossVolumeConfig | object | no | The OSS Volume configuration |
| teamID | string | no | The unique identifier of the team |
| volumeName | string | no | The name, which must be unique within the team |

### Deletes a specified API key
`POST https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/delete-api-key` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| apiKeyID | string | yes | The unique identifier of the API key |

### Deletes the quota configuration for a specified team
`POST https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/delete-quota` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| tagValue | string | no | The ID of the team to which the quota belongs |

### Deletes a specified team
`POST https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/delete-team` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| teamID | string | yes | The team ID |

### Deletes a template
`POST https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/delete-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| templateID | string | yes | The unique identifier of the template |
| teamID | string | no | The team ID |

### Deletes the template cache
`POST https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/delete-template-cache` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| templateID | string | yes | The unique identifier of the template |
| teamID | string | no | The team ID |

### Deletes a specified storage volume
`POST https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/delete-volume` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| volumeID | string | yes | The unique identifier of the storage volume |
| teamID | string | no | The ID of the team to which the storage volume belongs |

### Queries the details of a specified API key
`GET https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/describe-api-key` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| apiKeyID | string | yes | The unique identifier of the API key |

### Queries the quota configuration of a specified team
`GET https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/describe-quota` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| tagValue | string | no | The ID of the team to which the quota belongs |

### Queries the template cache
`GET https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/describe-template-cache` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| templateID | string | yes | The unique identifier of the template |
| teamID | string | no | The team ID |

### Queries the details of a specified team
`GET https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/get-team` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| teamID | string | yes | The team ID |

### Queries a template
`GET https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/get-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| templateID | string | yes | The unique identifier of the template |
| teamID | string | no | The team ID |

### Queries the details of a specified storage volume
`GET https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/get-volume` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| volumeID | string | yes | The unique identifier of the storage volume |
| teamID | string | no | The ID of the team to which the storage volume belongs |

### Queries the list of API keys by using paging
`GET https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/list-api-keys` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| apiKeyName | string | no | The name of the API key |
| status | string | no | Filters API keys by status. Valid values: active: Enabled. inactive: Disabled |
| pageNumber | integer | no | The page number. Default value: 1. Valid values: 1 to 10000 |
| pageSize | integer | no | The number of API keys to return on each page. Default value: 10. Valid values: 1 to 100 |
| teamID | string | no | The ID of the team |
| resourceGroupID | string | no | The ID of the resource group |
| userID | string | no | The user ID of the creator |

### Performs a paging query on the quota configurations for the current account
`GET https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/list-quota` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| maxResults | integer | no | The maximum number of records to return per page |
| nextToken | string | no | The pagination token. Leave this parameter empty for the first request. To query the next page, specify the nextToken value returned in… |

### Queries the list of teams by using paging
`GET https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/list-teams` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| teamName | string | no | The team name |
| resourceGroupID | string | no | The resource group ID |
| pageNumber | integer | no | The page number. Default value: 1. Valid values: 1 to 10000 |
| pageSize | integer | no | The number of teams to return on each page. Default value: 10. Valid values: 1 to 100 |
| plan | string | no | Filters teams by plan specifications. Valid values: eco (Economy), std (Standard), pro (Professional), and ent (Enterprise) |

### Performs a paging query of template caches
`GET https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/list-template-cache` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| teamID | string | no | The team ID |
| templateID | string | no | The unique identifier of the template |
| status | string | no | Filters by cache status. Valid values: InProgress, Success, Failed, Deleting, and Evicted |
| maxResults | integer | no | The maximum number of entries to return per page. Default value: 20. Maximum value: 100 |
| nextToken | string | no | The pagination token returned from the previous response |

### Performs a paged query to retrieve the template list with paging
`GET https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/list-templates` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| teamID | string | no | The team ID |
| maxResults | integer | no | The maximum number of entries to return per page. Default value: 20. Maximum value: 100 |
| nextToken | string | no | The pagination token. Set the value to the nextToken value returned in the response of the previous request |

### Queries a list of storage volumes by using paging
`GET https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/list-volumes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| volumeName | string | no | The name of the storage volume, which is unique within the team |
| status | string | no | Filters by storage volume status. Valid values: CREATING (creating), AVAILABLE (available), ERROR (error), and DELETING (deleting) |
| teamID | string | no | The ID of the team to which the storage volume belongs |
| resourceGroupID | string | no | The ID of the resource group |
| userID | string | no | The user ID of the creator |
| maxResults | integer | no | The maximum number of entries to return per page |
| nextToken | string | no | The pagination token. Leave this parameter empty for the first request. To query the next page, set this parameter to the nextToken value… |
| storageClass | string | no | Filters by storage class. Valid values: OSS, AGENTIC_BUCKET, AGENTIC_FS, and JUICE_FS |

### Resets a specified API key
`POST https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/reset-api-key` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| apiKeyID | string | yes | The unique identifier of the API key |

### Updates the configuration of a specified API key
`POST https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/update-api-key` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| apiKeyID | string | yes | The unique identifier of the API key |
| apiKeyName | string | no | The new name of the API key. The name can be up to 128 characters in length and can contain letters, digits, spaces, hyphens (-),… |
| expireTime | string | no | The expiration time of the API key, in UTC, in RFC 3339 format. Leave this parameter empty to indicate that the API key never expires |
| ipBlacklist | array | no | The IP blacklist. If specified, the existing blacklist is entirely overwritten. This parameter is mutually exclusive with ipWhitelist |
| ipWhitelist | array | no | The IP whitelist. If specified, the existing whitelist is entirely overwritten. This parameter is mutually exclusive with ipBlacklist |
| status | string | no | The new status of the API key. Valid values: active: Enabled. inactive: Disabled |

### Updates the quota configuration
`POST https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/update-quota` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| cpuCores | integer | no | The vCPU quota. Unit: cores |
| instanceCount | integer | no | The quota for the number of running instances |
| memoryGB | integer | no | The memory quota. Unit: GB |
| tagValue | string | no | The quota tag value, which is set to the team ID. Quotas are independently calculated based on this dimension |

### Updates the information of a specified team
`POST https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/update-team` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| description | string | no | The new description of the team |
| plan | string | no | The new plan specification of the team. Valid values: eco (economy), std (standard), pro (professional), ent (enterprise) |
| resourceGroupID | string | no | The ID of the new Alibaba Cloud resource group to which the team belongs |
| teamName | string | no | The new name of the team. The name can be modified only when allowUpdateTeamName of the team is set to true |
| teamID | string | yes | The team ID |

### Updates a template
`POST https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/update-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| templateID | string | yes | The template ID |
| teamID | string | no | The team ID |
| buildConfig | object | no | The build configuration |
| runtimeConfig | object | no | The runtime configuration |

### Updates the configuration of a specified storage volume
`POST https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/update-volume` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |
| volumeID | string | yes | The unique identifier of the storage volume |
| agenticBucketVolumeConfig | object | no | The AgenticBucket Volume configuration |
| agenticFSVolumeConfig | object | no | The AgenticFS Volume configuration |
| juiceFSVolumeConfig | object | no | The JuiceFS Volume configuration |
| mountConfig | object | no | The mount configuration |
| ossVolumeConfig | object | no | The OSS Volume configuration |
| teamID | string | no | The ID of the team to which the storage volume belongs |

### version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://sandbox.ap-southeast-1.aliyuncs.com |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/create-api-key" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Agent Sandbox API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-sandbox/create-api-key with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud Agent Sandbox API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud Agent Sandbox itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud Agent Sandbox API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-sandbox.

### What is the status of the Alibaba Cloud Agent Sandbox API?
Needs your own provider key (bring your own key)