# Alibaba Cloud AI-Native Big Data Service API

> Alibaba Cloud AI-Native Big Data Service API on Apizie: 13 endpoints (Creates an Agent, Creates a Skill, Generates a credential for direct file upload. The caller can use the returned upload policy to upload a…, Deletes a specified Agent, …) 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-ada/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Alibaba Cloud OpenAPI for AI-Native Big Data Service (ada, version 2026-07-01). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Creates an Agent
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ada/create-agent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ada.cn-hangzhou.aliyuncs.com |
| Name | string | yes | The Agent name, which is also the unique identifier that cannot be modified after creation |
| DisplayName | string | no | The display name of the Agent |
| Description | string | no | The description of the Agent |
| SystemPrompt | string | no | The system prompt |
| Tools | string | no | The reference list of MCP Server and Connector names. The same array supports both types of entries. Each entry specifies one type of… |
| Skills | string | no | The Skill reference list. For specific fields, see "Supplementary description of request parameters" |
| KnowledgeBases | string | no | The knowledge base reference list, which contains at most one element |
| Visibility | string | no | The visibility scope of the Agent. Valid values: user tenant Default value: user |

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ada.cn-hangzhou.aliyuncs.com |
| Name | string | yes | The unique identifier of the Skill. Only letters, digits, underscores, and hyphens are supported. The value can be up to 64 characters in… |
| Description | string | yes | The description of the Skill |
| Metadata | string | yes | The Skill metadata in JSON object format. Exactly one content source must be provided. For more information about the fields, see "Request… |
| Visibility | string | no | The visibility of the Skill. Valid values: user tenant Default value: user |

### Generates a credential for direct file upload. The caller can use the returned upload policy to upload a…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ada/create-transit-upload-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ada.cn-hangzhou.aliyuncs.com |
| PathPrefix | string | no | The path prefix used for object key isolation. This prefix has no Artifact business directory semantics. Default value: `default` |
| ExpireMs | integer | no | The validity period of the upload policy and the Transit record, in milliseconds. Valid values: 1000 to 604800000. The value is rounded… |
| FileShowName | string | yes | The display name of the file. The value must be 1 to 512 characters in length. The object key is generated by the server and is not… |
| Network | string | no | The network type of the upload address. Valid values: `public` and `internal`. Default value: `public` |

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ada.cn-hangzhou.aliyuncs.com |
| Name | string | yes | The name of the Agent to delete |

### Soft-deletes a Skill that the current caller has permission to modify
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ada/delete-skill` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ada.cn-hangzhou.aliyuncs.com |
| Name | string | yes | The name of the Skill to delete |

### Queries an agent visible to the current identity by name
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ada/get-agent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ada.cn-hangzhou.aliyuncs.com |
| Name | string | yes | The name of the agent |

### Queries a Skill by name that is visible to the current caller
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ada/get-skill` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ada.cn-hangzhou.aliyuncs.com |
| Name | string | yes | The Skill name |
| SkillVersion | integer | no | The release history version number to query. If omitted, the current Skill main record is returned |
| Network | string | no | The network type of the download URL. Valid values: public and internal. If omitted, no download URL is generated |

### Queries the metadata of a Transit file, including the upload status, file size, and expiration time, and…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ada/get-transit-meta` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ada.cn-hangzhou.aliyuncs.com |
| TransitId | string | no | The Transit ID. Specify at least one of this parameter and `FilePath`. If both are specified, this parameter takes precedence |
| FilePath | string | no | The opaque object path returned by `CreateTransitUploadPolicy`. Specify at least one of this parameter and `TransitId` |
| Network | string | no | The network type for the download URL. Valid values: `public` and `internal`. If this parameter is not specified, no download URL is… |
| ExpireMs | integer | no | The validity period of the temporary download URL, in milliseconds. The value must be an integer greater than or equal to 1000 and is… |

### Queries agents visible to the current identity by paging
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ada/list-agents` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ada.cn-hangzhou.aliyuncs.com |
| MaxResults | integer | no | The number of entries per page for cursor-based pagination. Valid values: 1 to 100. Default value: 20 |
| NextToken | string | no | The next page token returned in the previous response |
| PageNumber | integer | no | The page number for page number-based pagination. Minimum value: 1. Default value: 1 |
| PageSize | integer | no | The number of entries per page for page number-based pagination. Valid values: 1 to 100. Default value: 20 |
| CreatorId | string | no | Filters agents by the exact creator ID |
| Q | string | no | The search keyword. Matches the name, display name, or description |
| Visibility | string | no | Filters agents by visibility scope. Valid values: `user` and `tenant` |
| Scope | string | no | The query scope. Valid values: `SYSTEM` and `CUSTOM` |
| RequiredRuntime | string | no | Filters agents by runtime label |

### Queries Skills visible to the current caller by paging
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ada/list-skills` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ada.cn-hangzhou.aliyuncs.com |
| MaxResults | integer | no | The number of entries per page for cursor-based pagination. Valid values: 1 to 100. Default value: `20`. If explicitly specified,… |
| NextToken | string | no | The token returned by the server for the next page. Do not pass this parameter for the first query. For subsequent queries, use the value… |
| PageNumber | integer | no | The page number for compatible page-number-based pagination. Pages start from 1. Default value: `1` |
| PageSize | integer | no | The number of entries per page for compatible page-number-based pagination. Valid values: 1 to 100. Default value: `20` |
| CreatorId | string | no | Filters Skills by creator ID |
| Q | string | no | Performs a fuzzy match on the Skill name or description |
| Visibility | string | no | Filters Skills by visibility. Common values are `user` and `tenant` |
| Scope | string | no | The query scope for Skills. Valid values: `SYSTEM` and `CUSTOM`. If omitted, both official and custom Skills are queried |

### Updates the configuration of an Agent
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ada/update-agent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ada.cn-hangzhou.aliyuncs.com |
| Name | string | yes | The name of the Agent to update |
| ExpectedVersion | integer | no | The expected current configuration revision number. This parameter is omitted by default. For concurrency protection, pass in the… |
| DisplayName | string | no | The new display name. If not specified, the existing value is retained |
| Description | string | no | The new description. If not specified, the existing value is retained |
| SystemPrompt | string | no | The new system prompt. If not specified, the existing value is retained |
| Tools | string | no | The list of MCP Server and Connector name references. The same array supports both types of entries. Each entry specifies one type of… |
| Skills | string | no | The list of Skill references. If not specified, the existing value is retained. A non-empty array replaces the entire value. Passing `[ ]`… |
| KnowledgeBases | string | no | The list of knowledge base bindings, which contains at most one element. If not specified, the existing value is retained. A non-empty… |
| Visibility | string | no | The new visibility scope. Valid values: user tenant If not specified, the existing value is retained |

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ada.cn-hangzhou.aliyuncs.com |
| Name | string | yes | The name of the Skill to update. This parameter is used only to locate the Skill and cannot be used to modify the name |
| ExpectedVersion | integer | no | The expected version number |
| Description | string | no | The updated description of the Skill |
| Metadata | string | no | The updated Skill metadata. The JSON object is replaced as a whole. The content supports exactly one of Transit ID, bundleUrl, or skillMd |
| Visibility | string | no | The updated visibility. Valid values: `user` and `tenant` |

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ada.cn-hangzhou.aliyuncs.com |

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

## FAQ

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

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

### Can AI agents use the Alibaba Cloud AI-Native Big Data Service 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-ada.

### What is the status of the Alibaba Cloud AI-Native Big Data Service API?
Needs your own provider key (bring your own key)