# Alibaba Cloud STAROps API

> Alibaba Cloud STAROps API on Apizie: 35 endpoints (Creates an artifact upload credential, Creates a conversation, Creates a digital employee, Creates a skill for a digital employee, …) 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://apizie.tech/v1/cloud:aliyun-starops/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-starops`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/starops
- Page: https://apizie.tech/api/cloud/aliyun-starops
- OpenAPI: https://apizie.tech/api/cloud/aliyun-starops/openapi.json

Alibaba Cloud OpenAPI for STAROps (starops, version 2026-04-28). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Creates an artifact upload credential
`POST https://apizie.tech/v1/cloud:aliyun-starops/create-artifact-upload-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital human |
| artifactPath | string | no | The artifact upload directory, relative to the digital human artifact root directory. The value can only be empty or a directory under… |

### Creates a conversation
`POST https://apizie.tech/v1/cloud:aliyun-starops/create-chat` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| action | string | no | The action type. Valid values: create: creates a conversation. reconnect: reconnects to an existing conversation. stop: stops the… |
| digitalEmployeeName | string | no | The name of the digital employee |
| messages | array | no | The list of messages |
| threadId | string | no | The conversation thread ID |
| variables | object | no | The list of variables |

### Creates a digital employee
`POST https://apizie.tech/v1/cloud:aliyun-starops/create-digital-employee` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| attributes | object | no | The digital employee properties |
| channel | string | no | The channel type |
| defaultRule | string | no | The default rule of the digital employee |
| description | string | no | The description of the digital employee |
| displayName | string | no | The display name of the digital employee |
| knowledges | object | no | The list of knowledge bases |
| name | string | yes | The name of the digital employee |
| resourceGroupId | string | no | The resource group ID |
| roleArn | string | yes | The RAM role ARN |
| sandboxNetworkPolicy | object | no | The sandbox network ACL policy configuration of the digital employee |
| tags | array | no | The tags |
| toolPolicy | object | no | The tool policy |

### Creates a skill for a digital employee
`POST https://apizie.tech/v1/cloud:aliyun-starops/create-digital-employee-skill` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee |
| description | string | no | The description of the skill |
| displayName | string | no | The display name of the skill |
| enable | string | no | Specifies whether to enable the skill |
| files | array | yes | The files for the skill |
| remark | string | no | Remarks about the skill |
| skillName | string | yes | The name of the skill |

### Creates an MCP service
`POST https://apizie.tech/v1/cloud:aliyun-starops/create-mcp-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee |
| connection | object | yes | The request body parameters |
| description | string | no | The description of the MCP service |
| displayName | string | no | The display name of the MCP service |
| enable | string | yes | Specifies whether to enable the MCP service |
| mcpServiceName | string | yes | The service name of the MCP service |
| network | object | yes | The request body parameters |
| tools | array | yes | The list of MCP tools |

### Creates a thread
`POST https://apizie.tech/v1/cloud:aliyun-starops/create-thread` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee |
| attributes | object | no | Key-value pairs that you can attach to the thread |
| title | string | no | The title of the thread |
| variables | object | no | The variables for the thread. You can use them to pass custom data to the digital employee |

### Creates a ticket
`POST https://apizie.tech/v1/cloud:aliyun-starops/create-ticket` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| expirationTime | integer | no | The expiration time (in seconds) of the embedded page URL. Default value: 86400 (one day). Valid values: 0 to 2592000 (30 days) |
| accessTokenExpirationTime | integer | no | The expiration time (in seconds) of the access token, which specifies how long the user can access page operations. Default value: 86400… |

### Deletes a digital employee
`POST https://apizie.tech/v1/cloud:aliyun-starops/delete-digital-employee` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee |

### Deletes a skill from a digital employee
`POST https://apizie.tech/v1/cloud:aliyun-starops/delete-digital-employee-skill` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee |
| skillName | string | yes | The name of the skill |

### Deletes a public schema reference from a digital employee UModel
`POST https://apizie.tech/v1/cloud:aliyun-starops/delete-digital-employee-umodel-common-schema-ref` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee to which the UModel belongs |
| group | string | yes | The public schema group to delete |

### Deletes an MCP service
`POST https://apizie.tech/v1/cloud:aliyun-starops/delete-mcp-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee |
| mcpServiceName | string | yes | The MCP service name |

### This operation deletes a thread
`POST https://apizie.tech/v1/cloud:aliyun-starops/delete-thread` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee |
| threadId | string | yes | The thread ID |

### Retrieves the tool list from a remote MCP service
`POST https://apizie.tech/v1/cloud:aliyun-starops/fetch-remote-mcp-tools` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| connection | object | yes | The request body parameters |
| network | object | no | The request body parameters |

### Retrieves the content of an artifact
`GET https://apizie.tech/v1/cloud:aliyun-starops/get-artifact` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the Digital Employee |
| artifactPath | string | yes | The path to the artifact |

### Retrieves the download URL for an artifact
`GET https://apizie.tech/v1/cloud:aliyun-starops/get-artifact-download-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital worker |
| artifactPath | string | yes | The artifact file path, relative to the digital worker artifact root directory |

### Retrieves a digital employee
`GET https://apizie.tech/v1/cloud:aliyun-starops/get-digital-employee` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee |

### Queries the entity data of a digital human
`POST https://apizie.tech/v1/cloud:aliyun-starops/get-digital-employee-entity-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital human whose entity data you want to query |
| from | integer | yes | The UNIX timestamp, in seconds |
| query | string | yes | Only the .entity or .topo semantic sources of the current digital human can be queried. Explicit access to internal storage or external… |
| to | integer | yes | The UNIX timestamp, in seconds. The value must be greater than the value of from |

### Retrieves the details of a skill
`GET https://apizie.tech/v1/cloud:aliyun-starops/get-digital-employee-skill` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee |
| skillName | string | yes | The skill name |
| version | string | no | The historical version number |

### Queries the UModel of a digital employee
`GET https://apizie.tech/v1/cloud:aliyun-starops/get-digital-employee-umodel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee whose UModel you want to query |

### Queries an MCP service
`GET https://apizie.tech/v1/cloud:aliyun-starops/get-mcp-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee |
| mcpServiceName | string | yes | The service name of the MCP service |

### Retrieves a session
`GET https://apizie.tech/v1/cloud:aliyun-starops/get-thread` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee |
| threadId | string | yes | The session ID |

### Get session data
`GET https://apizie.tech/v1/cloud:aliyun-starops/get-thread-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee |
| threadId | string | yes | The unique identifier for the thread |
| nextToken | string | no | The pagination cursor |
| maxResults | integer | no | The maximum number of session entries to return. The maximum value is 100 |

### Lists artifacts
`GET https://apizie.tech/v1/cloud:aliyun-starops/list-artifacts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee |
| artifactPath | string | yes | The artifact path from which to list artifacts. If this parameter is not specified, artifacts are listed from the root directory |
| maxResults | integer | no | The maximum number of results to return. If more results are available, the response includes a `nextToken` to retrieve the next page |
| nextToken | string | no | The token used to retrieve the next page of results. You can obtain this token from the `nextToken` parameter of a previous response |

### Lists skill versions
`GET https://apizie.tech/v1/cloud:aliyun-starops/list-digital-employee-skill-versions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee |
| skillName | string | yes | The skill name |

### Lists skills
`GET https://apizie.tech/v1/cloud:aliyun-starops/list-digital-employee-skills` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The digital employee name |
| maxResults | integer | no | The maximum number of records to return in this request |
| nextToken | string | no | The token for the next page. A value of null indicates that there is no next page |
| skillName | string | no | The skill name |

### Lists digital employees
`GET https://apizie.tech/v1/cloud:aliyun-starops/list-digital-employees` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| maxResults | integer | no | The number of entries to return per page. Default value: 20. Maximum value: 100 |
| nextToken | string | no | The token for the next query |
| name | string | no | The name of the digital employee |
| employeeType | string | no | The type of the digital employee |
| channel | string | no | The channel type |
| displayName | string | no | The display name of the digital employee |
| tags | string | no | The tags (JSON-encoded) |
| resourceGroupId | string | no | The resource group ID |

### Queries the list of MCP services
`GET https://apizie.tech/v1/cloud:aliyun-starops/list-mcp-services` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee |
| maxResults | integer | no | The maximum number of entries to return in this query |
| nextToken | string | no | The pagination token for the next query |

### Lists sessions
`GET https://apizie.tech/v1/cloud:aliyun-starops/list-threads` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee |
| status | string | no | The session status |
| threadId | string | no | The session ID |
| maxResults | integer | no | The maximum number of results to return. Maximum value: 200 |
| nextToken | string | no | The pagination token |
| filter | string | no | The filter conditions for the query. If this parameter is not specified, all topics under the instance are queried (JSON-encoded) |
| includeMission | string | no | Specifies whether to include threads created by mission |

### Updates a digital employee
`POST https://apizie.tech/v1/cloud:aliyun-starops/update-digital-employee` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee |
| attributes | object | no | The attributes |
| defaultRule | string | no | The default rule of the digital employee |
| description | string | no | The description of the digital employee |
| displayName | string | no | The display name of the digital employee |
| knowledges | object | no | The knowledge base list |
| roleArn | string | no | The ARN of the RAM role |
| sandboxNetworkPolicy | object | no | The list of CIDRs or IP addresses that are allowed to be accessed |
| toolPolicy | object | no | The security policy configuration for tool calling of the digital employee |

### Updates a skill for a digital employee
`POST https://apizie.tech/v1/cloud:aliyun-starops/update-digital-employee-skill` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee |
| skillName | string | yes | The name of the skill |
| description | string | no | The description of the skill |
| displayName | string | no | The display name of the skill |
| enable | string | yes | Specifies whether the skill is enabled |
| files | array | yes | An array of skill files |
| remark | string | no | Notes or comments about the skill |

### Updates the UModel of a digital human
`POST https://apizie.tech/v1/cloud:aliyun-starops/update-digital-employee-umodel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital human whose UModel you want to update |
| description | string | yes | The updated UModel description of the digital human |

### Updates an MCP service
`POST https://apizie.tech/v1/cloud:aliyun-starops/update-mcp-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee |
| mcpServiceName | string | yes | The service name of the MCP service |
| connection | object | yes | The request body parameters |
| description | string | no | The description of the MCP service |
| displayName | string | no | The display name of the MCP service |
| enable | string | yes | Specifies whether to enable the MCP service |
| network | object | yes | The request body parameters |
| tools | array | yes | The list of MCP tools |

### Updates a session
`POST https://apizie.tech/v1/cloud:aliyun-starops/update-thread` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee |
| threadId | string | yes | The session ID |
| attributes | object | no | The properties |
| status | string | no | The session status |
| title | string | no | The session title |

### Creates or updates a public schema reference for a digital employee UModel
`POST https://apizie.tech/v1/cloud:aliyun-starops/upsert-digital-employee-umodel-common-schema-ref` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://starops.ap-southeast-1.aliyuncs.com |
| name | string | yes | The name of the digital employee to which the UModel belongs |
| group | string | yes | The public schema group to create or update |
| version | string | yes | The version of the public schema |

### version
`POST https://apizie.tech/v1/cloud:aliyun-starops/version` (byok)

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

## Example
```
curl "https://apizie.tech/v1/cloud:aliyun-starops/create-artifact-upload-token" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud STAROps API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:aliyun-starops/create-artifact-upload-token with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

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

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