# Alibaba Cloud Genomics API

> Alibaba Cloud Genomics API on Apizie: 51 endpoints (Stop specific tasks that are running but not yet in a final state within a workspace, Aborts a specific delivery task in a workspace, Copies a public dataset table to a workspace, Create applications in a workspace, …) 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-easygene/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Alibaba Cloud OpenAPI for Genomics (easygene, version 2021-03-15). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Stop specific tasks that are running but not yet in a final state within a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/abort-run` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | Workspace name |
| RunId | string | yes | Task ID |

### Aborts a specific delivery task in a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/abort-submission` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | Workspace name |
| SubmissionId | string | yes | Delivery ID |

### Copies a public dataset table to a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/copy-public-entity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Dataset | string | yes | Dataset name |
| EntityType | string | yes | Table name |
| Workspace | string | yes | Target workspace |

### Create applications in a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/create-app` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | Workspace name |
| AppName | string | yes | Application name |
| Definition | string | yes | Application definition |
| Path | string | yes | Main WDL path |
| RevisionTag | string | no | Application version tag, unique across all versions |
| Description | string | no | Application description |
| Language | string | no | Application description language |
| LanguageVersion | string | no | Application description language version |
| AppType | string | no | Application type |
| Documentation | string | no | Application usage document |
| RevisionComment | string | no | Description of the current application version |
| Labels | string | no | Application labels |
| ClientToken | string | no | Idempotent token |
| Dependencies | string | no | Dependent applications (JSON-encoded) |
| Configs | string | no | The reference data (JSON-encoded) |

### Creates an entity table in a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/create-entity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | The workspace. For more information about how to obtain the workspace, see Create a workspace… |
| EntityType | string | yes | The entity type. The value must be 1 to 64 characters in length |
| EntityItems | string | yes | An array of table elements. The maximum size is 512 KB (JSON-encoded) |
| ClientToken | string | no | The idempotence token. The value can be up to 64 characters in length |

### Creates a run task in a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/create-run` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | The name of the workspace |
| RunName | string | no | The name of the run task |
| AppName | string | yes | The name of the application |
| AppRevision | string | no | The version of the application |
| RevisionTag | string | no | The unique tag of the application version |
| Description | string | no | The description of the run task |
| Labels | string | no | The labels of the run task |
| ExecuteOptions | string | no | The configuration of the run task (JSON-encoded) |
| ExecuteDirectory | string | no | The execution directory of the run task |
| Role | string | no | Optional. The custom Resource Access Management (RAM) role. During the run task execution, the system assumes this role to access your… |
| OutputFolder | string | no | The directory to which the output of the run task is copied |
| DefaultRuntime | string | no | The default runtime |
| Inputs | string | yes | The inputs of the run task |
| ClientToken | string | no | The idempotency token of the run task |

### Create a submission to generate tasks in batches
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/create-submission` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | The workspace name |
| AppName | string | yes | The application name |
| Revision | string | no | The version number of the application |
| RevisionTag | string | no | The unique tag for the application version |
| EntityType | string | yes | The entity type |
| EntityNames | string | no | A list of entity names for the submission tasks (JSON-encoded) |
| ExecuteOptions | string | no | The task configuration |
| ExecuteDirectory | string | no | The directory where the task is executed |
| OutputFolder | string | no | The directory to which the task output is copied |
| DefaultRuntime | string | no | The default runtime environment |
| Inputs | string | no | The task inputs |
| Outputs | string | no | The task outputs |
| ClientToken | string | no | The idempotence token for the request |

### Creates an application template in a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/create-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | The workspace name |
| TemplateName | string | yes | The application template name |
| Description | string | no | The description of the application template |
| AppName | string | yes | The application name |
| AppRevision | string | no | The application version |
| RevisionTag | string | no | The unique tag for the application version |
| RootEntity | string | no | The root entity type |
| InputsExpression | string | yes | The expression of the application (JSON-encoded) |
| OutputsExpression | string | yes | Response parameters for the (application) (JSON-encoded) |
| Labels | string | no | The application labels |
| ClientToken | string | no | The idempotence token |

### Creates a workspace for a user
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/create-workspace` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | Workspace name |
| Description | string | no | Workspace description |
| ClientToken | string | no | Idempotency token |
| Storage | string | yes | OSS path for the workspace |
| JobLifecycle | integer | no | Task lifecycle for the workspace, in days |
| Role | string | no | RAM role for the workspace |
| Labels | string | no | Workspace labels |

### Delete applications that you no longer need
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/delete-app` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | Workspace name |
| AppName | string | yes | Application name |
| Revision | string | no | Application version |

### Deletes a specific entity table from a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/delete-entity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | The workspace |
| EntityType | string | yes | The entity type |

### Deletes data from a specific entity table in a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/delete-entity-items` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | The workspace |
| EntityType | string | yes | The entity type |
| EntityNames | string | yes | An array of the names of the elements to delete (JSON-encoded) |

### Delete a specific run record in a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/delete-run` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | Workspace name |
| RunId | string | yes | Task ID |

### Deletes a specific delivery task record in a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/delete-submission` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | Workspace name |
| SubmissionId | string | yes | Submission ID |

### Deletes a specified application template from a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/delete-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | Workspace name |
| TemplateName | string | yes | Application template name |

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

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

### Download entity table data from a workspace to a local file
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/download-entity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | Workspace |
| EntityType | string | yes | Entity type |
| EntityNames | string | no | Array of data element names to download (JSON-encoded) |

### Retrieves the details of a specific application in a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/get-app` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | The workspace name |
| AppName | string | yes | The application name |
| Revision | string | no | The version number of the application |
| RevisionTag | string | no | The unique tag for the application version |

### Queries the definition of a specific entity type in a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/get-entity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | The workspace |
| EntityType | string | yes | The entity type |

### Queries the details of a public application on the platform
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/get-global-app` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Attributes | string | no | The query field information (JSON-encoded) |
| NamespaceName | string | yes | The namespace |
| AppName | string | yes | The application name |
| AppVersion | string | no | The application version |
| Location | string | no | The region ID |

### Queries the details of a public dataset on the platform
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/get-public-dataset` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| DatasetName | string | yes | The name of the dataset |
| Attributes | string | no | Specifies the list of attributes to query (JSON-encoded) |

### Queries the definition of a specific entity from a public dataset on the platform
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/get-public-dataset-entity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| DatasetName | string | yes | Dataset name |
| EntityType | string | yes | Entity type |
| Location | string | no | Region ID |

### Retrieves task details
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/get-run` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | Workspace name |
| RunId | string | yes | Task ID |

### Queries the details of a specific delivery task in a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/get-submission` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | The workspace |
| SubmissionId | string | yes | The delivery ID |

### Queries the details of a specific application template in a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/get-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | Workspace name |
| TemplateName | string | yes | Application template name |

### Queries the details of a workspace, including the status, description, and job lifecycle
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/get-workspace` (byok)

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

### Imports a public platform application into a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/import-app` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Source | string | yes | Source |
| Workspace | string | yes | The workspace |
| AppName | string | yes | The name of the application after installation |

### Install a platform-wide application into your workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/install-global-app` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Source | string | yes | Source |
| NamespaceName | string | yes | Namespace name |
| AppName | string | yes | Application name |
| Workspace | string | yes | Workspace |
| InstalledAppName | string | yes | Installed application name |

### Lists the applications in a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/list-apps` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | The workspace |
| NextToken | string | no | The pagination token that is used in the next request to retrieve a new page of results |
| MaxResults | integer | no | The maximum number of results to return |
| OrderBy | string | no | The field to sort by |
| IsReversed | string | no | Specifies whether to sort the results in reverse order |
| LabelSelector | string | no | The label selector |
| Scope | string | no | The scope of the application |
| Language | string | no | The description language of the application |
| AppType | string | no | The application type |
| Search | string | no | The search keyword to match application names |

### Retrieves the list of third-party software
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/list-authorized-software` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Location | string | yes | The region ID |
| Search | string | no | The keyword used to search software names and long names |
| OrderBy | string | no | The field used for sorting |
| IsReversed | string | no | Specifies whether to reverse the sort order |
| NextToken | string | no | The pagination token that specifies the position from which to start reading. If you leave this parameter empty, the reading starts from… |
| MaxResults | integer | no | The maximum number of entries per page |

### Lists public container images provided by the platform
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/list-container-images` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Location | string | yes | Region ID |
| NextToken | string | no | Pagination token that marks the starting position for reading results. Leave this parameter empty to start from the beginning |
| MaxResults | integer | no | Maximum number of results per page |

### Queries for a list of entity types in a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/list-entities` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | Workspace |
| NextToken | string | no | Starting query position |
| MaxResults | integer | no | Maximum results |
| OrderBy | string | no | Sort condition |
| IsReversed | string | no | Is reversed |

### Retrieves the content of the data table for a specific entity in a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/list-entity-items` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | Workspace |
| EntityType | string | yes | Entity type |
| Search | string | no | Search condition |
| OrderBy | string | no | Sort condition |
| IsReversed | string | no | Whether to sort in reverse order |
| NextToken | string | no | Starting position for the query |
| MaxResults | integer | no | Maximum number of results to return |

### Queries the public applications on the platform
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/list-global-apps` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Search | string | no | The fuzzy search fields, such as NamespaceName, AppName, Categories, and AppDescription |
| OrderBy | string | no | The sort field |
| IsReversed | string | no | Specifies whether to sort the results in descending order. Default value: true |
| NextToken | string | no | The pagination token that specifies the start position for the current read operation. If you leave this parameter empty, the read… |
| MaxResults | integer | no | The maximum number of entries to return on each page |
| AppScope | string | no | The visibility scope. A value of OpenAccess indicates that the application is visible to all users |
| Category | string | no | The category |
| Toolkit | string | no | The toolkit |
| Location | string | no | The region ID |

### Lists the public datasets on the platform
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/list-public-dataset` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Search | string | no | Keywords to search in the name and description |
| Tag | string | no | The tag of the public dataset |
| OrderBy | string | no | The field to sort by |
| IsReversed | string | no | Sorts the results in descending order. The default value is true |
| NextToken | string | no | The token to retrieve the next page of results. Leave this empty to get the first page |
| MaxResults | integer | no | The number of results to return per page |

### Lists the entity types in a public dataset
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/list-public-dataset-entities` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| DatasetName | string | yes | Name of the public dataset |
| OrderBy | string | no | Field to sort by |
| IsReversed | string | no | Whether to reverse the sort order. Default is true |
| NextToken | string | no | Pagination token that marks the starting position for the next page. Leave empty to start from the beginning |
| MaxResults | integer | no | Maximum number of results per page |
| Location | string | no | Region ID |

### Queries the data table of a specific entity in a public dataset
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/list-public-dataset-entity-items` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| DatasetName | string | yes | Name of the dataset |
| EntityType | string | yes | Type of the entity |
| Search | string | no | Keyword to search for in the entity name |
| OrderBy | string | no | Field to sort by |
| IsReversed | string | no | Whether to reverse the sort order. Default is true |
| NextToken | string | no | Pagination token that marks the starting position for the next page. Leave empty to start from the beginning |
| MaxResults | integer | no | Maximum number of results per page |
| Location | string | no | Region ID |

### Retrieves the categorization tags for public datasets
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/list-public-dataset-tags` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Search | string | no | Keyword to search in tag names |
| OrderBy | string | no | Sort field: TagName, LastModified |
| IsReversed | string | no | Invert sort order |
| NextToken | string | no | Paging token. Marks the current read position. Leave empty to start from the beginning |
| MaxResults | integer | no | Number of items per page |

### Lists the regions supported by the gene analysis platform, such as North China 2 (Beijing)
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/list-regions` (byok)

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

### Retrieves a list of running tasks in a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/list-runs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | no | The workspace |
| Status | string | no | The status |
| SubmissionId | string | no | The submission ID |
| Search | string | no | The search ID |
| LabelSelector | string | no | The label selector |
| AppName | string | no | The application name |
| AppRevision | string | no | The version of the application |
| EntityType | string | no | The entity type |
| EntityName | string | no | The name of the entity element |
| NextToken | string | no | The starting position for the query |
| MaxResults | integer | no | The maximum number of results to return |
| OrderBy | string | no | The sort criterion |
| IsReversed | string | no | Specifies whether to reverse the sort order |
| GetTotal | string | no | Specifies whether to return the total number of tasks |

### Retrieves a list of submissions in a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/list-submissions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | The workspace |
| Status | string | no | The status |
| Search | string | no | The search ID |
| NextToken | string | no | Next Token |
| MaxResults | integer | no | The maximum number of items to return |
| OrderBy | string | no | The sort criterion |
| IsReversed | string | no | Specifies whether to sort the results in reverse order |

### Lists application templates in a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/list-templates` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | Workspace |
| NextToken | string | no | Token for the next query |
| MaxResults | integer | no | Maximum number of results to return |
| OrderBy | string | no | Sort by field |
| IsReversed | string | no | Reverse sort order |
| LabelSelector | string | no | Label selector |
| Search | string | no | Search condition |

### Lists recent tasks
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/list-user-active-runs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| MaxResults | integer | no | The maximum number of results to return |

### Lists the workspaces that meet specified conditions
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/list-workspaces` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Search | string | no | Search conditions |
| OrderBy | string | no | Sort by |
| IsReversed | string | no | Reverse order |
| NextToken | string | no | Start token for the query |
| MaxResults | integer | no | Maximum number of results to return |
| LabelSelector | string | no | Label selector |

### Resume a specific deliver task in a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/resume-submission` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | Workspace name |
| SubmissionId | string | yes | Delivery ID |

### Tags a version of an application
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/tag-app` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | The name of the workspace |
| AppName | string | yes | The name of the application |
| AppRevision | string | yes | The version of the application |
| RevisionTag | string | yes | The unique tag for the application version |

### Updates the data in a specific entity table within a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/update-entity-items` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | The workspace |
| EntityType | string | yes | The entity type |
| EntityItems | string | yes | The entity table data (JSON-encoded) |

### Updates the details of a specific application template in a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/update-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | The name of the workspace |
| TemplateName | string | yes | The name of the application template |
| Description | string | no | The description of the application template |
| RootEntity | string | no | The entity type |
| InputsExpression | string | yes | The input expression of the application (JSON-encoded) |
| OutputsExpression | string | yes | The output expression of the application (JSON-encoded) |
| Labels | string | no | The labels of the application template |

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | Workspace name |
| Description | string | no | Workspace description |
| JobLifecycle | integer | no | Job lifecycle within the workspace |
| Role | string | no | RAM role within the workspace |
| Labels | string | no | Workspace labels |

### Upload entity data tables to a workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-easygene/upload-entity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://easygene.cn-hangzhou.aliyuncs.com |
| Workspace | string | yes | Workspace |
| EntityCSVFile | string | yes | OSS path of the entity table CSV file |

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

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

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

## FAQ

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

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

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

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