# Tencent Cloud Application and Service Workflow API

> Tencent Cloud Application and Service Workflow API on Apizie: 9 endpoints (Create Flow Service, Describe Execution, Describe Execution History, Describe Executions, …) 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:tencent-asw/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:tencent-asw`
- Category: Cloud
- Status: byok
- Source: https://www.tencentcloud.com/document/api
- Page: https://zieapi.vercel.app/api/cloud/tencent-asw
- OpenAPI: https://zieapi.vercel.app/api/cloud/tencent-asw/openapi.json

Tencent Cloud API 3.0 for Application and Service Workflow (asw). Every call is signed with TC3-HMAC-SHA256 using your SecretId and SecretKey.

## Endpoints

### Create Flow Service
`POST https://zieapi.vercel.app/v1/cloud:tencent-asw/create-flow-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Definition | string | yes |  |
| FlowServiceName | string | yes |  |
| IsNewRole | boolean | yes |  |
| Type | string | yes |  |
| FlowServiceChineseName | string | no |  |
| RoleResource | string | no |  |
| Description | string | no |  |
| EnableCLS | boolean | no |  |
| Input | string | no |  |

### Describe Execution
`POST https://zieapi.vercel.app/v1/cloud:tencent-asw/describe-execution` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ExecutionResourceName | string | yes |  |

### Describe Execution History
`POST https://zieapi.vercel.app/v1/cloud:tencent-asw/describe-execution-history` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ExecutionResourceName | string | yes |  |

### Describe Executions
`POST https://zieapi.vercel.app/v1/cloud:tencent-asw/describe-executions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| StateMachineResourceName | string | yes |  |
| PageSize | integer | yes |  |
| PageIndex | integer | yes |  |
| FilterExecutionStatus | string | no |  |
| FilterExecutionResourceName | string | no |  |

### Describe Flow Service Detail
`POST https://zieapi.vercel.app/v1/cloud:tencent-asw/describe-flow-service-detail` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FlowServiceResource | string | yes |  |

### Describe Flow Services
`POST https://zieapi.vercel.app/v1/cloud:tencent-asw/describe-flow-services` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Offset | integer | no |  |
| Limit | integer | no |  |
| Filters | array | no |  |

### Modify Flow Service
`POST https://zieapi.vercel.app/v1/cloud:tencent-asw/modify-flow-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FlowServiceResource | string | yes |  |
| Definition | string | yes |  |
| FlowServiceName | string | yes |  |
| FlowServiceChineseName | string | yes |  |
| IsNewRole | boolean | yes |  |
| Type | string | yes |  |
| RoleResource | string | yes |  |
| Description | string | no |  |
| EnableCLS | boolean | no |  |

### Start Execution
`POST https://zieapi.vercel.app/v1/cloud:tencent-asw/start-execution` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| StateMachineResourceName | string | yes |  |
| Input | string | no |  |
| Name | string | no |  |

### Stop Execution
`POST https://zieapi.vercel.app/v1/cloud:tencent-asw/stop-execution` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ExecutionQrn | string | yes |  |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:tencent-asw/create-flow-service" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Tencent Cloud Application and Service Workflow API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:tencent-asw/create-flow-service with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Tencent Cloud Application and Service Workflow API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Tencent Cloud Application and Service Workflow itself also needs your own key from tencentcloudapi.com.

### Can AI agents use the Tencent Cloud Application and Service Workflow 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:tencent-asw.

### What is the status of the Tencent Cloud Application and Service Workflow API?
Needs your own provider key (bring your own key)