# Alibaba Cloud AgentTeams API

> Alibaba Cloud AgentTeams API on Apizie: 74 endpoints (Binds an upstream identity provider to a specified instance and triggers a synchronization task, Activates and configures an Internet NAT gateway for a specified AgentTeams instance, Creates a new key-value credential under a specified AgentTeams instance, Asynchronously creates a cluster instance with the specified configurations, …) 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-agentteams/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Alibaba Cloud OpenAPI for AgentTeams (agentteams, version 2026-06-05). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Binds an upstream identity provider to a specified instance and triggers a synchronization task
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/bind-identity-provider` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| IdentityProviderType | string | yes | The identity provider type. Currently, only DingTalk is supported |
| IdpMetadata | string | no | The identity provider metadata. In the DingTalk scenario, this is a JSON object string that contains the `appKey`, `appSecret`, `corpId`,… |
| LoginEnabled | string | no | Specifies whether to enable logon. Default value: `true`. This default value is used if the parameter is not specified or is left empty |
| SyncEnabled | string | no | Specifies whether to enable user synchronization. Default value: `false`. User synchronization is enabled only when this parameter is… |
| ClientToken | string | no | The client idempotency token that is used to ensure the idempotence of the request |

### Activates and configures an Internet NAT gateway for a specified AgentTeams instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/configure-nat-gateway` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The ID of the AgentTeams instance |
| Description | string | no | The description for the NAT gateway, EIP, and SNAT rule creation |
| EipBandwidth | integer | no | The bandwidth of the automatically applied EIP. Valid values: 1 to 200. Unit: Mbit/s |
| ClientToken | string | no | The client idempotency token |
| NatGatewayInstanceId | string | no | The ID of the NAT gateway instance |
| EipAllocationId | string | no | The allocation ID of the EIP |

### Creates a new key-value credential under a specified AgentTeams instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/create-credential` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The AgentTeams instance ID |
| Name | string | yes | The credential key. The value must match the regular expression `^[A-Z_\][A-Z0-9_\]*\$` |
| ApiKey | string | yes | The credential value. This is a sensitive field and is not returned in plaintext |
| Description | string | no | The credential description |
| ClientToken | string | no | The idempotency token that is used to ensure the idempotence of the request |

### Asynchronously creates a cluster instance with the specified configurations
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/create-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceName | string | yes | `instanceName`: `string`, required |
| InstanceSpec | string | yes | `instanceSpec`: `string`, optional, default `SMALL_X1` |
| VpcId | string | yes | `vpcId`: `string`, required |
| NetworkType | string | yes | `networkType`: `string`, optional, default `PRIVATE_NET` Valid values: `PRIVATE_PUBNET` `PRIVATE_NET` `PUB_NET` |
| ClientToken | string | no | The idempotency token that is used to ensure the idempotence of the request |
| PaymentType | string | no | The billing method |
| Zones | string | no | The zones (JSON-encoded) |

### Creates an MCP server
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/create-mcp` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| Name | string | yes | Optional. Fuzzy match by instance name |
| Addresses | string | yes | The list of MCP server addresses (JSON-encoded) |
| InstanceId | string | yes | The AgentTeams instance ID |
| Description | string | no | The description of the MCP server |
| CreateType | string | no | The creation type. Default value: DIRECT_PROXY |
| AuthEnabled | string | no | Specifies whether to enable authentication |
| AuthConfig | string | no | The authentication information |
| SwaggerConfig | string | no | The Swagger configuration. This parameter is required if Type is set to HTTP_TO_MCP |
| ClientToken | string | no | The client idempotency token that is used to ensure the idempotence of the request |
| Protocol | string | no | The protocol type |

### Creates an AI model under a specified AgentTeams instance. You must specify the model name, the model…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/create-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Name | string | yes | Optional. Fuzzy matches instances by name |
| Protocols | string | yes | The list of protocols supported by the model, in JSON format (JSON-encoded) |
| Description | string | no | The model description |
| ProviderName | string | yes | The name of the model provider |
| ProviderId | string | yes | The ID of the model provider |
| ClientToken | string | no | The idempotency token that ensures the idempotence of the request |
| Provider | string | no | The provider identifier |

### Creates an AI model provider under a specified AgentTeams instance. You must specify the provider name,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/create-model-provider` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| Name | string | yes | Optional. The instance name for fuzzy matching |
| Provider | string | yes | Optional. The instance status for exact matching |
| Address | string | yes | The address of the model provider |
| Protocols | string | yes | The list of protocols supported by the model provider, in JSON format (JSON-encoded) |
| ApiKeys | string | yes | The list of API keys for the model provider, in JSON format (JSON-encoded) |
| InstanceId | string | yes | The instance ID |
| Description | string | no | The description of the model provider |
| ClientToken | string | no | The idempotency token that ensures the idempotence of the request |

### Creates an endpoint for a specified instance. Multiple component types and gateway types are supported
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/create-service-endpoint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Component | string | yes | The component type. Valid values: `ELEMENT`, `TUNNEL`, `MATRIX`, and `WORKER` |
| CertIdentifier | string | no | The certificate ID |
| ResourceName | string | no | The service name |
| Domain | string | no | The custom domain name. The server trims and converts the value to lowercase |
| ClientToken | string | no | The idempotency token that ensures the idempotence of the request |

### Creates a team under a specified instance. You can set the team name, description, administrator, and…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/create-team` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | no | The instance ID |
| Name | string | no | The team name |
| TeamMembers | string | no | The initial member list of the team (JSON-encoded) |
| Description | string | no | The team description |
| AdminName | string | no | The team administrator name. The administrator must be an existing user under the instance with sufficient permissions |
| ClientToken | string | no | The idempotency token that is used to ensure the idempotence of the request |

### Creates a user under a specified instance. You can set the username, display name, email address,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/create-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Name | string | yes | The name |
| DisplayName | string | no | The display name |
| Email | string | no | The email address |
| AuthMethod | string | no | The authentication method |
| Note | string | no | The note |
| Password | string | no | The password. If not specified, the system automatically generates an initial password |
| ClientToken | string | no | The idempotency token that is used to ensure the idempotence of the request |

### Creates a Worker instance with specified configurations such as model, skills, template, MCP servers, and…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/create-worker` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | no | The instance ID |
| Name | string | no | The name |
| VersionCode | string | no | The Worker version number |
| Model | string | no | The model configuration (JSON-encoded) |
| Soul | string | no | The Soul configuration |
| Agents | string | no | The Agents configuration |
| Skills | string | no | The list of skills (JSON-encoded) |
| Template | string | no | The template configuration (JSON-encoded) |
| McpServers | string | no | The list of MCP servers (JSON-encoded) |
| Channels | string | no | The list of channel configurations (JSON-encoded) |
| ClientToken | string | no | The idempotency token that ensures the idempotence of the request |
| Groups | string | no | The list of team groups (JSON-encoded) |
| Subagents | string | no | The list of sub-agents (JSON-encoded) |
| AgentType | string | no | The Agent runtime type |
| DeployType | string | no | The deployment type |
| Credentials | string | no | The list of credential bindings (JSON-encoded) |
| LimitConfig | string | no | The quota configuration (JSON-encoded) |

### Creates a local management bootstrap token for a Worker, with support for specifying the network type
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/create-worker-bootstrap-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Name | string | yes | The name |
| NetworkType | string | yes | The network type |

### Deletes an existing credential from a specified AgentTeams instance. The credential cannot be deleted if it…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/delete-credential` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The AgentTeams instance ID |
| Name | string | yes | The name of the credential |
| ClientToken | string | no | The idempotence token that ensures the idempotency of the request |

### Releases a specified AgentTeams instance and cleans up related resources. Supports GET and POST methods.…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/delete-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The ID of the AgentTeams instance to release |

### Deletes an MCP server from a specified AgentTeams instance. The server cannot be deleted if it is associated…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/delete-mcp` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| Id | string | yes | Optional. Fuzzy matches by instance name |
| InstanceId | string | yes | The ID of the AgentTeams instance |

### Deletes an AI model from a specified AgentTeams instance. The model cannot be deleted if it is still…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/delete-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Id | string | yes | The model ID |
| ProviderId | string | no | The model provider ID |

### Deletes an AI model provider from a specified AgentTeams instance. The provider cannot be deleted if it…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/delete-model-provider` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Id | string | yes | The ID of the model provider |

### Deletes an endpoint from a specified AgentTeams instance and cleans up related resources
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/delete-service-endpoint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| EndpointId | string | yes | Endpoint ID |
| InstanceId | string | yes | The instance ID |

### Deletes a team under a specified instance. After deletion, the team and associated resources enter an…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/delete-team` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Name | string | yes | The name |

### Deletes a specified user from a specified instance. After deletion, the user cannot log on to or access…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/delete-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Name | string | yes | The name |

### Deletes a Worker under a specified instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/delete-worker` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Name | string | yes | The name |

### Queries the details of a specified credential under an AgentTeams instance, including the status,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/get-credential` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The AgentTeams instance ID |
| Name | string | yes | The name |

### Queries the binding details of an upstream identity provider for a specified instance and identity provider…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/get-identity-provider` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| IdentityProviderType | string | yes | The identity provider type. Currently, only DingTalk is supported |

### Queries the details of a specified instance by instance ID. Supports GET and POST methods. A successful…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/get-instance` (byok)

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

### Queries the status of asynchronous tasks associated with a specified AgentTeams instance, with pagination…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/get-instance-async-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The ID of the AgentTeams instance |
| TaskCode | string | no | The task code. If not specified, all asynchronous tasks are queried. You can pass in a `TaskCode` to filter results. To query multiple… |
| MaxResults | integer | no | The page size. Default value: `100`. Valid values: `1` to `100` |
| NextToken | string | no | The token for the next page. Do not specify this parameter for the first request |
| Status | string | no | The task status filter |

### Retrieves the RAM authorization URL required to mount OSS to ACS for an instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/get-instance-oss-mount-ram-authorize-url` (byok)

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

### Queries the details of a specified MCP server, including the address, authentication configuration,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/get-mcp` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | Optional. The instance name for fuzzy matching |
| Id | string | yes | The MCP server ID |

### Queries the model call summary for a specified AgentTeams instance within a specified time range, including…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/get-model-invocation-summary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | no | The instance ID |
| StartTime | string | no | The start time of the query. Unit: milliseconds (UNIX timestamp) |
| EndTime | string | no | The end time of the query. Unit: milliseconds (UNIX timestamp) |

### Queries the details of a single AI model provider, including the name, address, protocol list, API keys, and…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/get-model-provider` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | Optional. Fuzzy matches by instance name |
| Id | string | yes | The ID of the model provider |

### Queries the configuration status of the NAT gateway and its SNAT rules for a specified instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/get-nat-gateway-status` (byok)

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

### Queries the details of an endpoint with a specified ID. You can verify the endpoint by instance ID
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/get-service-endpoint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| EndpointId | string | yes | Endpoint ID |
| InstanceId | string | yes | The instance ID |

### Queries the task statistics summary of a specified AgentTeams instance within a specified time range,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/get-task-stats-summary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | no | The instance ID |
| StartTime | string | no | The query start time. Unit: milliseconds (UNIX timestamp) |
| EndTime | string | no | The query end time. Unit: milliseconds (UNIX timestamp) |

### Queries the details of a specified team under a specified instance, including the description,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/get-team` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Name | string | yes | The name |

### Queries the token consumption trend of a specified AgentTeams instance within a specified time range,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/get-token-trend` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | no | The instance ID |
| StartTime | string | no | The query start time. Unit: milliseconds (UNIX timestamp) |
| EndTime | string | no | The query end time. Unit: milliseconds (UNIX timestamp) |
| GroupBy | string | no | The grouping dimension, such as by day or by hour |

### Queries the tool calling distribution of a specified AgentTeams instance within a specified time range, and…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/get-tool-call-distribution` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | no | The instance ID |
| StartTime | string | no | The start time of the query. This value is a UNIX timestamp in milliseconds |
| EndTime | string | no | The end time of the query. This value is a UNIX timestamp in milliseconds |

### Queries the details of a specified user under a specified instance, including the username, display name,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/get-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Name | string | yes | The name |

### Retrieves the initial password of a specified user under a specified instance. The initial password is…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/get-user-password` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Name | string | yes | The name |

### Queries the details of a specified worker, including configurations such as model, skills, sub-agents, MCP…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/get-worker` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Name | string | yes | The name |

### Queries the startup options for local Worker management and returns available network types
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/get-worker-bootstrap-options` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Name | string | yes | The name |

### Queries the maximum upgradable version of a worker
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/get-worker-max-version` (byok)

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

### Queries the Worker statistics summary, including the total number of workers, the number of running workers,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/get-worker-stats-summary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | no | The instance ID |
| StartTime | string | no | The start time for statistics collection. This value is a UNIX timestamp in milliseconds |
| EndTime | string | no | The end time for statistics collection. This value is a UNIX timestamp in milliseconds |

### Queries the credential list under a specified AgentTeams instance with paging, returning credential summary…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/list-credentials` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The AgentTeams instance ID |
| MaxResults | integer | no | The maximum number of entries per page. Valid values: 1 to 100. Default value: 10 |
| NextToken | string | no | The pagination token. Leave this parameter empty for the first request. For subsequent requests, use the NextToken value returned in the… |
| NameLike | string | no | The keyword for fuzzy match of the credential name |

### Queries the list of upstream identity provider bindings for a specified instance, with support for paginated…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/list-identity-providers` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| MaxResults | integer | no | The maximum number of entries to return in this query. Valid values: 1 to 100. Default value: 10 |
| NextToken | string | no | The pagination token that indicates the offset from which to start the query. The value must be a non-negative integer. Do not specify… |

### Queries a list of instances that meet the specified conditions. Supports pagination and fuzzy match.…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/list-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceName | string | no | Description: The instance name. Supports fuzzy match |
| Status | string | no | Description: The instance status |
| MaxResults | integer | no | Description: The page size. Default value: 20 Current implementation limit: 1 to 100 |
| NextToken | string | no | Description: The pagination token for the next page |
| Skip | integer | no | Description: The number of records to skip. Default value: 0 |

### Queries the list of tools provided by a specified MCP server, including tool names, titles, descriptions,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/list-mcp-tools` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The AgentTeams instance ID |
| Id | string | yes | Optional. The exact match filter for instance status |

### Queries the MCP server list under a specified AgentTeams instance by using paging
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/list-mcps` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | Optional. Fuzzy matches by instance name |
| MaxResults | integer | no | The maximum number of records per page |
| NextToken | string | no | The token for the next page, used for paginated queries |

### Queries the list of AI model providers under a specified AgentTeams instance. Paging is supported
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/list-model-providers` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | Optional. Fuzzy matches by instance name |
| MaxResults | integer | no | The maximum number of entries to return per page |
| NextToken | string | no | The pagination token used to retrieve the next page of results |

### Queries the list of AI models under a specified AgentTeams instance. You can filter results by model name or…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/list-models` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | Optional. Fuzzy match by instance name |
| MaxResults | integer | no | The maximum number of entries to return per page |
| NextToken | string | no | The pagination token used to retrieve the next page of results |
| ProviderName | string | no | The model provider name used for filtering |
| Name | string | no | The name |
| Id | string | no | The model ID used to query a specific model |

### Queries the list of AI gateway endpoints under a specified instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/list-service-endpoints` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The AgentTeams instance ID |
| Component | string | no | The endpoint component. Valid values: ELEMENT, MATRIX, WORKER, and TUNNEL |
| ResourceName | string | no | The service name. Exact match is used |
| NetworkType | string | no | The network type. Valid values: INTRANET and INTERNET |
| DomainType | string | no | The domain name type. Valid values: BUILTIN and CUSTOM |
| Skip | string | no | The number of records to skip |
| NextToken | string | no | The pagination token used to retrieve the next page of data |
| MaxResults | integer | no | The maximum number of records to return in this request |

### Queries the list of SSL certificates available to the user in APIG
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/list-ssl-certs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The AgentTeams instance ID. This parameter is used to verify the ownership of the current user's instance and to query certificates by the… |
| MaxResults | integer | no | The maximum number of records to return in this request |
| NextToken | string | no | The pagination token used to retrieve the next page of data |

### Queries the statistical details of teams under a specified instance, including aggregate metrics such as the…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/list-team-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | no | The instance ID |
| StartTime | string | no | The start time of the statistical interval. The value is a millisecond-level timestamp string |
| EndTime | string | no | The end time of the statistical interval. The value is a millisecond-level timestamp string |
| MaxResults | integer | no | The maximum number of records to return in this request |
| NextToken | string | no | The pagination token used to retrieve the next page of data |

### Queries the task list of a specified team under a specified instance. The task metadata is sourced from the…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/list-team-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Team | string | yes | The team name |
| MaxResults | integer | no | The maximum number of records to return in this request. Valid values: 1 to 100. Default value: 10 |
| NextToken | string | no | The pagination token, which is the offset integer string returned from the previous page |

### Queries the list of teams under a specified instance, with support for fuzzy filtering by name and pagination
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/list-teams` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| NameLike | string | no | The keyword for fuzzy match of team names |
| MaxResults | integer | no | The maximum number of records to return in this request. Valid values: 1 to 100. Default value: 10 |
| NextToken | string | no | The pagination token. Set this parameter to the offset integer string returned by the previous request |

### Queries the list of users under a specified instance. Supports fuzzy match by username and paging query. The…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/list-users` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| NameLike | string | no | The keyword for fuzzy match by username |
| MaxResults | integer | no | The page size. Default value: 10. Valid values: 1 to 100 |
| NextToken | string | no | The pagination token for the next page. A non-negative integer that represents the offset |

### Queries a list of Worker statistics details by paging, including task count, token usage, and LLM call count
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/list-worker-stats-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | no | The instance ID |
| StartTime | string | no | The start time for statistics. This value is a UNIX timestamp in milliseconds |
| EndTime | string | no | The end time for statistics. This value is a UNIX timestamp in milliseconds |
| MaxResults | integer | no | The maximum number of entries to return per page |
| NextToken | string | no | The pagination token used to query the next page of data |

### Queries the list of Workers under a specified instance by using paging, with support for filtering by name,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/list-workers` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| MaxResults | integer | no | The maximum number of entries to return per page. Valid values: 1 to 100. Default value: 10 |
| Mcp | string | no | The MCP server name filter |
| NameLike | string | no | The fuzzy match filter for the Worker name |
| ModelName | string | no | The model name filter |
| ModelProvider | string | no | The model provider filter |
| VersionCode | string | no | The Worker version number filter |
| NextToken | string | no | The pagination token used to query the next page of data |
| Group | string | no | The team group filter (JSON-encoded) |
| Template | string | no | The template filter (JSON-encoded) |
| AgentType | string | no | The Agent runtime type filter |
| Credential | string | no | The credential name filter |

### Creates or updates a CMS workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/put-cms-workspace` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The AgentTeams instance ID |

### Queries the attribute status of a specified instance, worker, team, or individual
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/query-features` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The AgentTeams instance ID |
| TargetScope | string | yes | The query target type: `INSTANCE` / `WORKER` / `TEAM` / `HUMAN` |
| ResourceName | string | no | The target resource name. Required for `WORKER`, `TEAM`, and `HUMAN`. Not required for `INSTANCE` |

### Retrieves all zone IDs supported by the current AgentTeams Resource Pool configuration
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/query-supported-zones` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| MaxResults | integer | no | The page size |
| NextToken | string | no | The token for the next page |

### Resets the password of a specified user under a specified instance. After the reset, the user must log on…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/reset-user-password` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Name | string | yes | The name |
| Password | string | no | The new password |

### Tests the connectivity of an AI model provider and model under a specified AgentTeams instance by sending a…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/test-model-provider` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| ProviderId | string | yes | The provider ID. Optional. Filters by exact match on instance status |
| ModelName | string | yes | The model name. Optional. Filters by fuzzy match on instance name |
| Prompt | string | yes | The content of the test prompt |
| ProviderName | string | yes | The name of the model provider |

### Unbinds the upstream identity provider from a specified instance, dissociates the identity federation…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/unbind-identity-provider` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| IdentityProviderType | string | no | The identity provider type. Currently, only DingTalk is supported. Specify this parameter to locate the binding to be unbound |

### Updates the plaintext key of an existing credential in an AgentTeams instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/update-credential` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The AgentTeams instance ID |
| Name | string | yes | The name |
| ApiKey | string | yes | The credential value |
| ClientToken | string | no | The idempotency token that is used to ensure the idempotence of the request |
| Description | string | no | The credential description |

### Updates the upstream identity provider configuration bound to a specified instance. You can adjust the logon…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/update-identity-provider` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| LoginEnabled | string | no | Specifies whether to enable logon. If this parameter is not specified, the existing configuration is retained |
| SyncEnabled | string | no | Specifies whether to enable user synchronization. If this parameter is not specified, the existing configuration is retained |
| ClientToken | string | no | The client idempotency token that is used to ensure the idempotence of the request |
| IdentityProviderType | string | yes | The identity provider type. Currently, only DingTalk is supported |
| IdpMetadata | string | no | The identity provider metadata. In the DingTalk scenario, this is a JSON object string that contains the appKey, appSecret, corpId,… |

### Changes the name of a specified AgentTeams instance. This operation supports GET and POST methods. You can…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/update-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The ID of the AgentTeams instance |
| InstanceName | string | no | The new instance name. This parameter cannot be empty |
| ClientToken | string | no | The idempotency token that is used to ensure the idempotence of the request |
| Zones | string | no | The list of zones and vSwitches (JSON-encoded) |
| NetworkType | string | no | The network type |

### Restarts a paused asynchronous task for creating an instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/update-instance-async-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The AgentTeams instance ID |
| TaskCode | string | yes | The asynchronous task code. Only `agentteams:pay-order:create` is supported |
| TaskId | string | yes | The asynchronous task ID |
| IsResume | string | no | Specifies whether to resume the task |

### Updates the configuration of a specified MCP server, including the address list, authentication information,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/update-mcp` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The AgentTeams instance ID |
| Id | string | yes | Optional. Fuzzy matches by instance name |
| Addresses | string | yes | The address list of the MCP server (JSON-encoded) |
| Description | string | no | The description of the MCP server |
| AuthEnabled | string | no | Specifies whether to enable authentication |
| AuthConfig | string | no | The authentication information |
| SwaggerConfig | string | no | Required if Type is set to HTTP_TO_MCP |
| CreateType | string | no | The creation type |
| ClientToken | string | no | The client idempotency token that ensures the idempotence of the request |

### Updates the description and other information of an AI model in a specified AgentTeams instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/update-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Id | string | yes | The model ID |
| Description | string | no | The model description |
| ClientToken | string | no | The idempotency token that is used to ensure the idempotence of the request |

### Updates the address, protocol list, API key, and other information of an AI model provider in a specified…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/update-model-provider` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| Address | string | yes | The address of the model provider |
| Protocols | string | yes | The list of protocols supported by the model provider, in JSON format (JSON-encoded) |
| ApiKeys | string | yes | The list of API keys for the model provider, in JSON format (JSON-encoded) |
| InstanceId | string | yes | The instance ID |
| Id | string | yes | The model provider ID |
| Description | string | no | The description of the model provider |
| ClientToken | string | no | The idempotency token that is used to ensure the idempotence of the request |

### Updates the domain name and SSL certificate information for a specified endpoint
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/update-service-endpoint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| EndpointId | string | yes | The globally unique endpoint ID |
| Domain | string | no | The new domain name. If this parameter is not specified, the existing domain name is retained |
| CertIdentifier | string | no | The new SSL certificate identifier. If this parameter is not specified, the existing certificate is retained |
| ClientToken | string | no | The idempotency token that is used to ensure the idempotence of the request |
| InstanceId | string | yes | The instance ID |

### Updates the description and member list of a team under a specified instance, and returns the latest team…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/update-team` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | no | The instance ID |
| Name | string | no | The name |
| Description | string | no | The team description |
| ClientToken | string | no | The idempotency token that is used to ensure the idempotence of the request |
| TeamMembers | string | no | The team member list. If specified, this overwrites the existing members entirely (JSON-encoded) |

### Updates the information of a specified user under a specified instance, including the display name, email…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/update-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Name | string | yes | The name |
| DisplayName | string | no | The display name |
| Email | string | no | The email address |
| Note | string | no | The remarks |
| ClientToken | string | no | The idempotency token that is used to ensure the idempotence of the request |
| AuthMethod | string | no | The authentication method |

### Updates the configuration of a specified Worker, including model, skills, template, MCP servers, channels,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentteams/update-worker` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentteams.ap-southeast-1.aliyuncs.com |
| InstanceId | string | yes | The instance ID |
| Name | string | yes | The name |
| VersionCode | string | no | The Worker version number |
| Model | string | no | The model configuration (JSON-encoded) |
| Template | string | no | The template configuration (JSON-encoded) |
| McpServers | string | no | The list of MCP servers (JSON-encoded) |
| Channels | string | no | The list of channel configurations (JSON-encoded) |
| ClientToken | string | no | The idempotency token that ensures the idempotence of the request |
| Soul | string | no | The Soul configuration |
| Agents | string | no | The Agents configuration |
| Skills | string | no | The list of skills (JSON-encoded) |
| Credentials | string | no | The list of credential bindings (JSON-encoded) |
| LimitConfig | string | no | The quota configuration (JSON-encoded) |

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

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

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

## FAQ

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

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

### Can AI agents use the Alibaba Cloud AgentTeams 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-agentteams.

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