# Alibaba Cloud ITag API

> Alibaba Cloud ITag API on Apizie: 39 endpoints (Assign personnel to the worker nodes (annotation, quality inspection, and validation) of an annotation job, Append data to a job, Create an annotation job for the current tenant, You can add a new template for the current tenant and customize the annotation template based on your…, …) 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-openitag/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Alibaba Cloud OpenAPI for ITag (openitag, version 2022-06-16). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Assign personnel to the worker nodes (annotation, quality inspection, and validation) of an annotation job
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openitag/add-work-node-workforce` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For information about how to obtain the tenant ID, see https://help.aliyun.com/document_detail/454649.html |
| TaskId | string | yes | Job ID. For information about how to obtain the job ID, see https://help.aliyun.com/document_detail/454662.html |
| WorkNodeId | string | yes | Worker node ID, which corresponds to the pipeline sequence starting from 0. For example, in the sequence annotation → quality inspection →… |
| UserIds | array | no | User List |

### Append data to a job
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openitag/append-all-data-to-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For information about how to obtain a tenant ID, see https://help.aliyun.com/document_detail/454649.html |
| TaskId | string | yes | Job ID. For information about how to obtain a job ID, see https://help.aliyun.com/document_detail/454662.html |
| BizCode | string | no | The BizCode |
| DataMeta | array | no | The data list. A maximum of 100 records can be included in a single call. Each element in the array is a map |
| TraceId | string | no | TraceId |
| UUID | string | no | The unique identifier, controlled by the caller |

### Create an annotation job for the current tenant
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openitag/create-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID, which can be queried by using the ListTenantId API to retrieve the tenant list |
| Admins | object | no | Administrators; defaults to the Creator |
| AllowAppendData | string | no | Indicates whether appending new data is supported. Valid values: true: Supported false: Not supported |
| AssignConfig | object | yes | Job assignment mechanism |
| DatasetProxyRelations | array | yes | List of dataset configurations |
| Exif | object | no | Additional configuration. JSON format |
| Tags | array | no | List of job labels. |
| TaskName | string | yes | Job name |
| TaskTemplateConfig | object | no | Template Configuration |
| TaskWorkflow | array | yes | List of pipelines |
| TemplateId | string | yes | Template ID. For more information, see https://help.aliyun.com/document_detail/454654.html |
| UUID | string | yes | Unique identifier (UUID), controlled by the business side |
| VoteConfigs | object | no | Vote configuration |

### You can add a new template for the current tenant and customize the annotation template based on your…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openitag/create-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For information about how to query the tenant ID, see https://help.aliyun.com/document_detail/454649.html. |
| Classify | string | no | Template categorization |
| Description | string | no | Template description |
| Exif | object | no | Template additional information |
| QuestionConfigs | array | yes | List of question widget configurations |
| RobotConfigs | array | no | List of assisted annotation configurations |
| SharedMode | string | no | Template shared mode |
| Tags | array | no | List of tag information |
| TemplateId | string | no | Template ID |
| TemplateName | string | yes | Template Name |
| ViewConfigs | object | yes | View layer configuration |

### Add a member to the tenant
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openitag/create-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For information about how to obtain a tenant ID, see https://help.aliyun.com/document_detail/454649.html |
| AccountNo | string | yes | UID of the RAM user (sub-account) under the current Alibaba Cloud account (primary account). For information about how to obtain the UID,… |
| AccountType | string | yes | Account type. Only ALIYUN is currently supported |
| Role | string | yes | Role. Valid values: OPERATOR: Annotator. ADMIN: Administrator. LEADER: Annotation team leader |
| UserName | string | no | Username |

### Delete a job under the current tenant
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openitag/delete-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID, which can be queried by using the API for querying the tenant list (ListTenantId) |
| TaskId | string | yes | Job ID, which can be obtained from the Task Hub in iTAG |

### Delete the template under the current tenant.
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openitag/delete-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID, which can be queried by using the API for querying the tenant list (ListTenantId). |
| TemplateId | string | yes | Template ID, which can be obtained from template management in iTAG. |

### Delete a member within a tenant.
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openitag/delete-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID, which can be queried by invoking the API for listing tenants (ListTenantId). |
| UserId | string | yes | User ID |

### Export the result data of an annotation job
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/export-annotations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For information about how to obtain a tenant ID, see https://help.aliyun.com/document_detail/454649.html |
| TaskId | string | yes | Job ID. For information about how to obtain a job ID, see https://help.aliyun.com/document_detail/454662.html |
| Target | string | no | Target |
| OssPath | string | yes | OSS path |
| RegisterDataset | string | no | Specifies whether to register the result as a PAI dataset. Valid values: true: Registers the annotation result as a PAI dataset. false:… |

### Query the information of a single annotation export result.
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/get-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID, which can be queried by using the API for querying the tenant list (ListTenantId). |
| JobId | string | yes | Job ID, which can be obtained from the Task Hub in iTAG. |
| JobType | string | no | Task Type. Currently, only DOWNLOWD_MARKRESULT_FLOW is available. |

### Query the information of a single subtask package
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/get-subtask` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For more information about how to obtain a tenant ID, see https://help.aliyun.com/document_detail/454649.html |
| TaskID | string | yes | Task ID. For more information about how to obtain a task ID, see https://help.aliyun.com/document_detail/454662.html |
| SubtaskId | string | yes | Subtask ID. For more information about how to obtain a subtask ID, see https://help.aliyun.com/document_detail/454675.html |

### Query a single annotated data item in a subtask package
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/get-subtask-item` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For more information about how to obtain a tenant ID, see https://help.aliyun.com/document_detail/454649.html |
| TaskId | string | yes | Task ID. For more information about how to obtain a task ID, see https://help.aliyun.com/document_detail/454662.html |
| SubtaskId | string | yes | Subtask ID. For more information about how to obtain a subtask ID, see https://help.aliyun.com/document_detail/454675.html |
| ItemId | string | yes | Data item ID. For more information about how to obtain a data item ID, see https://help.aliyun.com/document_detail/454677.html |

### Query the information of a single annotation job.
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/get-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For information about how to query the tenant ID, see https://help.aliyun.com/document_detail/454649.html. |
| TaskId | string | yes | Job ID. For information about how to query the job ID, see https://help.aliyun.com/document_detail/454662.html. |

### Query the current statistics information of a job
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/get-task-statistics` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For more information about how to obtain a tenant ID, see https://help.aliyun.com/document_detail/454649.html |
| TaskId | string | yes | Job ID. For more information about how to obtain a job ID, see https://help.aliyun.com/document_detail/454662.html |
| StatType | string | no | Statistics Type. Valid values: OPERATORCELL: Operation cell. ITEM: Single item |

### Query the current status of a job
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/get-task-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For information about how to obtain a tenant ID, see https://help.aliyun.com/document_detail/454649.html |
| TaskId | string | yes | Job ID. For information about how to obtain a job ID, see https://help.aliyun.com/document_detail/454662.html |

### Query the current template information of a job.
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/get-task-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For more information about how to obtain a tenant ID, see https://help.aliyun.com/document_detail/454649.html. |
| TaskId | string | yes | Job ID. For more information about how to obtain a job ID, see https://help.aliyun.com/document_detail/454662.html. |

### Query job template questions.
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/get-task-template-questions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID, which can be queried by using the ListTenantId API to retrieve the tenant list. |
| TaskId | string | yes | Job ID, which can be obtained from the Task Hub in iTAG. |

### Query the data display information in the job template.
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/get-task-template-views` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID, which can be queried by using the ListTenantId API for querying the tenant list. |
| TaskId | string | yes | Job ID, which can be obtained from the Task Hub in iTAG. |

### Query the personnel configuration information of each node in a job.
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/get-task-workforce` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For more information about how to obtain a tenant ID, see https://help.aliyun.com/document_detail/454649.html. |
| TaskId | string | yes | Job ID. For more information about how to obtain a job ID, see https://help.aliyun.com/document_detail/454662.html. |

### Queries the statistical data of members in a task
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/get-task-workforce-statistic` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | The tenant ID. For information about how to obtain the tenant ID, see https://help.aliyun.com/document_detail/454649.html |
| TaskId | string | yes | The task ID. For information about how to obtain the task ID, see https://help.aliyun.com/document_detail/454662.html |
| PageNumber | integer | no | The page number of the task member list. Pages start from 1. Default value: 1 |
| PageSize | integer | no | The Settings for the number of node members to return on each page during paging in a paged query. Default value: 20 |
| StatType | string | no | The statistics type. Valid values: ITEM: by single audit record OPERATORCELL: by operation unit, where an ITEM may contain multiple… |

### Query template information under a tenant.
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/get-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID, which can be queried by invoking the ListTenantId API for the tenant list. |
| TemplateId | string | yes | Template ID, which can be obtained from template management in iTAG. |

### Query question information such as Radio and Multiple Choice in a template.
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/get-template-questions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. You can query it by using the ListTenantId API to retrieve the tenant list. |
| TemplateId | string | yes | Template ID, which can be obtained from template management in iTAG. |

### Query the display information such as images, text, and audio in the template.
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/get-template-view` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID, which can be queried using the ListTenantId API for tenant list. |
| TemplateId | string | yes | Template ID, which can be obtained from the template management feature in iTAG. |

### Query information about the iTAG tenant
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/get-tenant` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For information about how to obtain a tenant ID, see https://help.aliyun.com/document_detail/454649.html |

### Query the details of a single member in a tenant.
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/get-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For more information about how to obtain a tenant ID, see https://help.aliyun.com/document_detail/454649.html. |
| UserId | string | yes | User ID. For more information about how to query a User ID, see https://help.aliyun.com/document_detail/454688.html. |

### Displays a list of all exported annotation results
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/list-jobs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For information about how to obtain a tenant ID, see https://help.aliyun.com/document_detail/454649.html |
| PageSize | integer | no | The page number of the annotation result list. The starting value is 1, and the default value is 1. |
| PageNumber | integer | no | The quantity of annotation results displayed per page in a paged query. The default value is 20. |
| JobType | string | no | Task Type. Currently, only DOWNLOWD_MARKRESULT_FLOW is available |

### Display the annotation data of a single subtask package.
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/list-subtask-items` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For information about how to obtain a tenant ID, see https://help.aliyun.com/document_detail/454649.html. |
| TaskID | string | yes | Task ID. For information about how to obtain a task ID, see https://help.aliyun.com/document_detail/454662.html |
| SubtaskId | string | yes | The subtask ID. For information about how to obtain a subtask ID, see https://help.aliyun.com/document_detail/454675.html |
| PageNumber | integer | no | The page number of the annotated data for task packages. The starting value is 1, and the default value is 1 |
| PageSize | integer | no | The number of annotated data entries per page to display in a paged query. Default value is 20 |

### Displays the list of subtask packages
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/list-subtasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For information about how to obtain a tenant ID, see https://help.aliyun.com/document_detail/454649.html |
| TaskID | string | yes | For information about how to obtain a task ID, see https://help.aliyun.com/document_detail/454662.html |
| PageNumber | integer | no | The page number of the subtask List. The starting value is 1, and the default value is 1 |
| PageSize | integer | no | The number of subtasks displayed per page in a paged query. Default value is 20 |

### Displays the list of annotation jobs for the current tenant.
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/list-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. You can query it by using the ListTenantId API to retrieve the tenant list. |
| PageNumber | integer | no | Page number |
| PageSize | integer | no | Page size |

### Display the template list of the current tenant
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/list-templates` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID, which can be queried by using the ListTenants API to query the tenant list |
| PageNumber | integer | no | Page number |
| PageSize | integer | no | Page size |
| SearchKey | string | no | Search content |
| Types | string | no | List of application types (JSON-encoded) |

### Query iTAG tenants under an Alibaba Cloud account
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/list-tenants` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| PageSize | integer | no | Number of tenants displayed per page in a paged query. Default value: 20 |
| PageNumber | integer | no | Page number of the tenant list. The starting value is 1. Default value: 1 |

### Displays all annotate members under the current tenant
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openitag/list-users` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For information about how to obtain a tenant ID, see https://help.aliyun.com/document_detail/454649.html |
| PageSize | integer | no | Page number of the annotate member list. The starting value is 1. The default value is 1 |
| PageNumber | integer | no | The number of annotated members displayed per page in a paged query. Default value: 20 |

### Delete Node Personnel
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openitag/remove-work-node-workforce` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For how to obtain the Tenant ID, see https://help.aliyun.com/document_detail/454649.html |
| TaskId | string | yes | Task ID. For how to obtain the Task ID, see https://help.aliyun.com/document_detail/454662.html |
| WorkNodeId | string | yes | Work node ID, workflow sequence starting from 0. For example, in Labeling-QC-Acceptance, Labeling is 0, QC is 1, and Acceptance is 2 |
| UserIds | array | no | User IDs |

### Modify a job under the current tenant.
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openitag/update-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID, which can be queried by using the API for querying the tenant list (ListTenantId). |
| TaskId | string | yes | Job ID, which can be obtained from the Task Hub in iTAG. |
| Exif | object | no | Extended field |
| Remark | string | no | Remark information |
| Tags | array | no | List of labels |
| TaskName | string | no | Task Name |

### Update job members
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openitag/update-task-workforce` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For information about how to obtain a tenant ID, see https://help.aliyun.com/document_detail/454649.html |
| TaskId | string | yes | For information about how to obtain a job ID, see https://help.aliyun.com/document_detail/454662.html |
| Workforce | array | no | User List |

### Modify the template under the current tenant.
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openitag/update-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID, which can be queried by using the API for querying the tenant list (ListTenantId). |
| TemplateId | string | yes | Template ID, which can be obtained from template management in iTAG. |
| Classify | string | no | Template categorization |
| Description | string | no | Template description |
| Exif | object | no | Template additional information |
| QuestionConfigs | array | yes | List of question widget configurations |
| RobotConfigs | array | no | List of assisted annotation configurations |
| SharedMode | string | no | Template shared mode |
| Tags | array | no | List of tag information |
| TemplateName | string | yes | Template Name |
| ViewConfigs | object | yes | View layer configuration |

### Modify the information of an iTAG tenant
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openitag/update-tenant` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For information about how to query a tenant ID, see https://help.aliyun.com/document_detail/454649.html |
| Description | string | no | Tenant description |
| TenantName | string | no | Tenant name |

### Update member information within a tenant
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openitag/update-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| TenantId | string | yes | Tenant ID. For information about how to obtain a tenant ID, see https://help.aliyun.com/document_detail/454649.html |
| UserId | string | yes | User ID. For information about how to query a User ID, see https://help.aliyun.com/document_detail/454688.html |
| Role | string | yes | Role. Possible values: OPERATOR: Annotator. ADMIN: Administrator. LEADER: Annotation team leader |
| UserName | string | yes | Username |

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

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-openitag/add-work-node-workforce" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

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

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

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

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