# Tencent Cloud CloudBase Run API

> Tencent Cloud CloudBase Run API on Apizie: 22 endpoints (Create Cloud Run Env, Create Cloud Run Server, Delete Cloud Run Server, Delete Cloud Run Versions, …) 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:tencent-tcbr/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:tencent-tcbr`
- Category: Cloud
- Status: byok
- Source: https://www.tencentcloud.com/document/api
- Page: https://apizie.tech/api/cloud/tencent-tcbr
- OpenAPI: https://apizie.tech/api/cloud/tencent-tcbr/openapi.json

Tencent Cloud API 3.0 for CloudBase Run (tcbr). Every call is signed with TC3-HMAC-SHA256 using your SecretId and SecretKey.

## Endpoints

### Create Cloud Run Env
`POST https://apizie.tech/v1/cloud:tencent-tcbr/create-cloud-run-env` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| PackageType | string | yes |  |
| Alias | string | no |  |
| FreeQuota | string | no |  |
| Flag | string | no |  |
| VpcId | string | no |  |
| SubNetIds | array | no |  |
| ReqKey | string | no |  |
| Source | string | no |  |
| Channel | string | no |  |
| EnvId | string | no |  |

### Create Cloud Run Server
`POST https://apizie.tech/v1/cloud:tencent-tcbr/create-cloud-run-server` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EnvId | string | yes |  |
| ServerName | string | yes |  |
| DeployInfo | object | yes |  |
| ServerConfig | object | no |  |
| Items | array | no |  |
| VpcInfo | object | no |  |

### Delete Cloud Run Server
`POST https://apizie.tech/v1/cloud:tencent-tcbr/delete-cloud-run-server` (byok)

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

### Delete Cloud Run Versions
`POST https://apizie.tech/v1/cloud:tencent-tcbr/delete-cloud-run-versions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EnvId | string | yes |  |
| IsDeleteServer | boolean | yes |  |
| IsDeleteImage | boolean | yes |  |
| SimpleVersions | array | yes |  |
| OperatorRemark | string | no |  |

### Describe Cloud Run Deploy Record
`POST https://apizie.tech/v1/cloud:tencent-tcbr/describe-cloud-run-deploy-record` (byok)

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

### Describe Cloud Run Envs
`POST https://apizie.tech/v1/cloud:tencent-tcbr/describe-cloud-run-envs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EnvId | string | no |  |
| IsVisible | boolean | no |  |
| Channels | array | no |  |

### Describe Cloud Run Pod List
`POST https://apizie.tech/v1/cloud:tencent-tcbr/describe-cloud-run-pod-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EnvId | string | yes |  |
| ServerName | string | yes |  |
| VersionName | string | no |  |
| PageSize | integer | no |  |
| PageNum | integer | no |  |

### Describe Cloud Run Process Log
`POST https://apizie.tech/v1/cloud:tencent-tcbr/describe-cloud-run-process-log` (byok)

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

### Describe Cloud Run Server Detail
`POST https://apizie.tech/v1/cloud:tencent-tcbr/describe-cloud-run-server-detail` (byok)

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

### Describe Cloud Run Servers
`POST https://apizie.tech/v1/cloud:tencent-tcbr/describe-cloud-run-servers` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EnvId | string | yes |  |
| PageSize | integer | no |  |
| PageNum | integer | no |  |
| ServerName | string | no |  |
| ServerType | string | no |  |
| VpcId | string | no |  |

### Describe Env Base Info
`POST https://apizie.tech/v1/cloud:tencent-tcbr/describe-env-base-info` (byok)

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

### Describe Release Order
`POST https://apizie.tech/v1/cloud:tencent-tcbr/describe-release-order` (byok)

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

### Describe Server Manage Task
`POST https://apizie.tech/v1/cloud:tencent-tcbr/describe-server-manage-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EnvId | string | yes |  |
| ServerName | string | yes |  |
| TaskId | integer | yes |  |
| OperatorRemark | string | no |  |

### Describe Version Detail
`POST https://apizie.tech/v1/cloud:tencent-tcbr/describe-version-detail` (byok)

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

### Operate Server Manage
`POST https://apizie.tech/v1/cloud:tencent-tcbr/operate-server-manage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EnvId | string | yes |  |
| ServerName | string | yes |  |
| TaskId | integer | yes |  |
| OperateType | string | yes |  |
| OperatorRemark | string | no |  |

### Release Gray
`POST https://apizie.tech/v1/cloud:tencent-tcbr/release-gray` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EnvId | string | yes |  |
| ServerName | string | yes |  |
| GrayType | string | yes |  |
| TrafficType | string | yes |  |
| VersionFlowItems | array | no |  |
| OperatorRemark | string | no |  |
| GrayFlowRatio | integer | no |  |

### Search Cls Log
`POST https://apizie.tech/v1/cloud:tencent-tcbr/search-cls-log` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EnvId | string | yes |  |
| StartTime | string | yes |  |
| EndTime | string | yes |  |
| QueryString | string | yes |  |
| Limit | integer | yes |  |
| Context | string | no |  |
| Sort | string | no |  |
| UseLucene | boolean | no |  |
| LogType | integer | no |  |

### Start Version Instance
`POST https://apizie.tech/v1/cloud:tencent-tcbr/start-version-instance` (byok)

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

### Stop Version Instance
`POST https://apizie.tech/v1/cloud:tencent-tcbr/stop-version-instance` (byok)

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

### Submit Server Config Change Diff
`POST https://apizie.tech/v1/cloud:tencent-tcbr/submit-server-config-change-diff` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EnvId | string | yes |  |
| ServerName | string | yes |  |
| Conf | object | no |  |
| Items | array | no |  |

### Submit Server Rollback
`POST https://apizie.tech/v1/cloud:tencent-tcbr/submit-server-rollback` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EnvId | string | yes |  |
| ServerName | string | yes |  |
| CurrentVersionName | string | yes |  |
| RollbackVersionName | string | yes |  |
| OperatorRemark | string | no |  |

### Update Cloud Run Server
`POST https://apizie.tech/v1/cloud:tencent-tcbr/update-cloud-run-server` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EnvId | string | yes |  |
| ServerName | string | yes |  |
| DeployInfo | object | yes |  |
| ServerConfig | object | no |  |
| Business | string | no |  |
| Items | array | no |  |

## Example
```
curl "https://apizie.tech/v1/cloud:tencent-tcbr/create-cloud-run-env" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Tencent Cloud CloudBase Run API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:tencent-tcbr/create-cloud-run-env with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Tencent Cloud CloudBase Run 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:tencent-tcbr.

### What is the status of the Tencent Cloud CloudBase Run API?
Needs your own provider key (bring your own key)