AppGallery Connect, mapped for the terminal

Move every release through one red line.

A Go command center for discovering, dry-running, and invoking AppGallery Connect APIs—with stable JSON for people, CI, and coding agents.

Get started Browse 156 interfaces

13 API families156 registered interfaces3 output formats

agc / productionreference mode

One command surface. Your workflow.

AUTHPS256 / OAuth

PROFILEproject-bound

PACKAGEupload + status

RELEASEinvoke by choice

$ agc auth check --pretty

{
  "data": {
    "name": "production",
    "mode": "service-account",
    "active": true
  },
  "affordances": {
    "next": "agc publishing endpoints"
  }
}

project profile resolved · dry-run on

Dry-run firstNothing is sent until you opt in.

Agent-readableJSON envelopes include next actions.

One surfaceCLI, local REST, and web share a registry.

Install agc CLI

Use the package manager for your system.

macOS installs through the Createitv Homebrew tap with brew tap createitv/tap && brew install agc-cli. Windows installs through Scoop from the Createitv bucket.

macOS Homebrew command

$ brew tap createitv/tap && brew install agc-cli && agc version

Windows Scoop command

PS> if (!(Get-Command scoop -ErrorAction SilentlyContinue)) { Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force; irm get.scoop.sh | iex }; scoop bucket add createitv https://github.com/Createitv/scoop-bucket; scoop install agc-cli; agc version

Homebrew formula: agc-cli Versioned GitHub Release binary Winget PR submitted for Microsoft review

The release rail

Context flows forward. Secrets do not.

Each stage owns one job. Credentials remain local, project context remains portable, and destructive API calls require an explicit switch.

AUTH

PS256 / OAuth

PROFILE

project-bound

PACKAGE

upload + status

RELEASE

invoke by choice

Automatic profile binding

Choose once per project. Override only when you mean it.

Bind production in .agc/project.json. Commands resolve the profile in a predictable order, while --profile staging remains available for one-off work.

1CLI override--profile staging
2Project default.agc/project.json
3Active account~/.agc/credentials.json

.agc/project.json project safe

{
  "appId": "123456789",
  "projectId": "987654321",
  "packageName": "com.example.app",
  "profile": "production"
}

No client keys or private keys are stored here.

Interface registry

Discover the API before writing the request.

Every entry carries its method, path, parameter locations, CLI command, REST route, and dry-run path.

Selected family / pms

PMS

registered

HarmonyOS and Android products, subscriptions, promotions, review resources, and prices.

DISCOVERagc pms endpoints --output table

STATUSagc pms status --pretty

LOCAL REST/api/v1/pms

40 typed interface entries

All endpoints 40

Expand an endpoint for registered parameters and commands. Consult its reference for full schemas, responses, and permissions.

POST创建商品addproduct-android/api/pms/product-price-service/v1/manage/product

此接口用于创建商品定义信息，包含商品价格，展示语言等。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms addproduct-android --pretty

Local REST definition

/api/v1/pms/endpoints/addproduct-android

Dry run (supply required parameters first)

agc pms addproduct-android --invoke --dry-run=true --body body.json

Read endpoint reference ↗

POST创建商品addproduct-harmonyosnext/api/pms/product-price-service/v2/manage/product

此接口用于创建商品定义信息，包含商品价格，展示语言等。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms addproduct-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/addproduct-harmonyosnext

Dry run (supply required parameters first)

agc pms addproduct-harmonyosnext --invoke --dry-run=true --body body.json

Read endpoint reference ↗

POST创建商品订阅分组信息addproductgroup-android/api/pms/product-price-service/v1/manage/product/group

此接口用于创建商品订阅分组信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms addproductgroup-android --pretty

Local REST definition

/api/v1/pms/endpoints/addproductgroup-android

Dry run (supply required parameters first)

agc pms addproductgroup-android --invoke --dry-run=true --body body.json

Read endpoint reference ↗

POST创建商品订阅分组信息addproductgroup-harmonyosnext/api/pms/product-price-service/v2/manage/product/group

此接口用于创建商品订阅分组信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms addproductgroup-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/addproductgroup-harmonyosnext

Dry run (supply required parameters first)

agc pms addproductgroup-harmonyosnext --invoke --dry-run=true --body body.json

Read endpoint reference ↗

POST创建商品促销信息addpromotion-android/api/pms/product-price-service/v1/manage/product/promotion

此接口用于创建商品促销信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms addpromotion-android --pretty

Local REST definition

/api/v1/pms/endpoints/addpromotion-android

Dry run (supply required parameters first)

agc pms addpromotion-android --invoke --dry-run=true --body body.json

Read endpoint reference ↗

POST创建商品促销信息addpromotion-harmonyosnext/api/pms/product-price-service/v2/manage/product/promotion

此接口用于创建商品促销信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms addpromotion-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/addpromotion-harmonyosnext

Dry run (supply required parameters first)

agc pms addpromotion-harmonyosnext --invoke --dry-run=true --body body.json

Read endpoint reference ↗

GET查询关联APP已有商品类型basicapplication-harmonyosnext/api/pms/product-price-service/v2/manage/application/basic

此接口用于查询关联APP已有商品类型。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Inspect definition

agc pms basicapplication-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/basicapplication-harmonyosnext

Dry run (supply required parameters first)

agc pms basicapplication-harmonyosnext --invoke --dry-run=true

Read endpoint reference ↗

PUT批量激活商品batchactproduct-android/api/pms/product-price-service/v1/manage/product/batchActive

此接口用于批量激活商品。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms batchactproduct-android --pretty

Local REST definition

/api/v1/pms/endpoints/batchactproduct-android

Dry run (supply required parameters first)

agc pms batchactproduct-android --invoke --dry-run=true --body body.json

Read endpoint reference ↗

PUT批量激活商品batchactproduct-harmonyosnext/api/pms/product-price-service/v2/manage/product/batchActive

此接口用于批量激活商品，生效已下线商品，已结束的促销不会重新生效。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms batchactproduct-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/batchactproduct-harmonyosnext

Dry run (supply required parameters first)

agc pms batchactproduct-harmonyosnext --invoke --dry-run=true --body body.json

Read endpoint reference ↗

PUT批量上线商品促销活动batchactpromotion-android/api/pms/product-price-service/v1/manage/product/promotion/batchActive

此接口用于批量上线商品促销活动。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms batchactpromotion-android --pretty

Local REST definition

/api/v1/pms/endpoints/batchactpromotion-android

Dry run (supply required parameters first)

agc pms batchactpromotion-android --invoke --dry-run=true --body body.json

Read endpoint reference ↗

PUT批量上线商品促销活动batchactpromotion-harmonyosnext/api/pms/product-price-service/v2/manage/product/promotion/batchActive

此接口用于批量上线商品促销活动。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms batchactpromotion-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/batchactpromotion-harmonyosnext

Dry run (supply required parameters first)

agc pms batchactpromotion-harmonyosnext --invoke --dry-run=true --body body.json

Read endpoint reference ↗

POST批量创建商品batchaddproduct-android/api/pms/product-price-service/v1/manage/product/batchImportProducts

此接口用于批量创建商品定义信息，展示语言，商品价格，促销活动信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms batchaddproduct-android --pretty

Local REST definition

/api/v1/pms/endpoints/batchaddproduct-android

Dry run (supply required parameters first)

agc pms batchaddproduct-android --invoke --dry-run=true --body body.json

Read endpoint reference ↗

POST批量创建商品batchaddproduct-harmonyosnext/api/pms/product-price-service/v2/manage/product/batchImportProducts

此接口用于批量创建商品定义信息，展示语言，商品价格，促销活动信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms batchaddproduct-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/batchaddproduct-harmonyosnext

Dry run (supply required parameters first)

agc pms batchaddproduct-harmonyosnext --invoke --dry-run=true --body body.json

Read endpoint reference ↗

PUT批量去激活商品batchdeactproduct-android/api/pms/product-price-service/v1/manage/product/batchDeactive

此接口用于批量去激活商品。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms batchdeactproduct-android --pretty

Local REST definition

/api/v1/pms/endpoints/batchdeactproduct-android

Dry run (supply required parameters first)

agc pms batchdeactproduct-android --invoke --dry-run=true --body body.json

Read endpoint reference ↗

PUT批量去激活商品batchdeactproduct-harmonyosnext/api/pms/product-price-service/v2/manage/product/batchDeactive

此接口用于批量去激活商品，下线已生效商品，结束促销活动。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms batchdeactproduct-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/batchdeactproduct-harmonyosnext

Dry run (supply required parameters first)

agc pms batchdeactproduct-harmonyosnext --invoke --dry-run=true --body body.json

Read endpoint reference ↗

PUT批量下线商品促销活动batchdeactpromotion-android/api/pms/product-price-service/v1/manage/product/promotion/batchDeactive

此接口用于批量下线商品促销活动。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms batchdeactpromotion-android --pretty

Local REST definition

/api/v1/pms/endpoints/batchdeactpromotion-android

Dry run (supply required parameters first)

agc pms batchdeactpromotion-android --invoke --dry-run=true --body body.json

Read endpoint reference ↗

PUT批量下线商品促销活动batchdeactpromotion-harmonyosnext/api/pms/product-price-service/v2/manage/product/promotion/batchDeactive

此接口用于批量下线商品促销活动。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms batchdeactpromotion-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/batchdeactpromotion-harmonyosnext

Dry run (supply required parameters first)

agc pms batchdeactpromotion-harmonyosnext --invoke --dry-run=true --body body.json

Read endpoint reference ↗

PUT批量更新商品batchupdateproduct-android/api/pms/product-price-service/v1/manage/product/batchImportProducts

此接口用于批量更新商品定义信息，展示语言，商品价格，促销活动信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms batchupdateproduct-android --pretty

Local REST definition

/api/v1/pms/endpoints/batchupdateproduct-android

Dry run (supply required parameters first)

agc pms batchupdateproduct-android --invoke --dry-run=true --body body.json

Read endpoint reference ↗

PUT批量更新商品batchupdateproduct-harmonyosnext/api/pms/product-price-service/v2/manage/product/batchImportProducts

此接口用于批量更新商品定义信息，展示语言，商品价格，促销活动信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms batchupdateproduct-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/batchupdateproduct-harmonyosnext

Dry run (supply required parameters first)

agc pms batchupdateproduct-harmonyosnext --invoke --dry-run=true --body body.json

Read endpoint reference ↗

POST按条件查询商品信息bygetproductinfo-android/api/pms/product-price-service/v1/manage/product/list

此接口用于商品查询，支持多条件过滤，根据productNo和AppId唯一查询一个商品信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms bygetproductinfo-android --pretty

Local REST definition

/api/v1/pms/endpoints/bygetproductinfo-android

Dry run (supply required parameters first)

agc pms bygetproductinfo-android --invoke --dry-run=true --body body.json

Read endpoint reference ↗

POST按条件查询商品信息bygetproductinfo-harmonyosnext/api/pms/product-price-service/v2/manage/product/list

此接口用于商品查询，支持多条件过滤，根据productNo和AppId唯一查询一个商品信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms bygetproductinfo-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/bygetproductinfo-harmonyosnext

Dry run (supply required parameters first)

agc pms bygetproductinfo-harmonyosnext --invoke --dry-run=true --body body.json

Read endpoint reference ↗

POST按条件查询商品促销信息bygetpromotioninfo-android/api/pms/product-price-service/v1/manage/product/promotion/list

此接口用于商品促销查询，支持多条件过滤。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms bygetpromotioninfo-android --pretty

Local REST definition

/api/v1/pms/endpoints/bygetpromotioninfo-android

Dry run (supply required parameters first)

agc pms bygetpromotioninfo-android --invoke --dry-run=true --body body.json

Read endpoint reference ↗

POST按条件查询商品促销信息bygetpromotioninfo-harmonyosnext/api/pms/product-price-service/v2/manage/product/promotion/list

此接口用于商品促销查询，支持多条件过滤。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms bygetpromotioninfo-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/bygetpromotioninfo-harmonyosnext

Dry run (supply required parameters first)

agc pms bygetpromotioninfo-harmonyosnext --invoke --dry-run=true --body body.json

Read endpoint reference ↗

POST查询商品订阅分组信息getproductgroup-android/api/pms/product-price-service/v1/manage/product/group/list

此接口用于查询商品订阅分组信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms getproductgroup-android --pretty

Local REST definition

/api/v1/pms/endpoints/getproductgroup-android

Dry run (supply required parameters first)

agc pms getproductgroup-android --invoke --dry-run=true --body body.json

Read endpoint reference ↗

POST查询商品订阅分组信息getproductgroup-harmonyosnext/api/pms/product-price-service/v2/manage/product/group/list

此接口用于查询商品订阅分组信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms getproductgroup-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/getproductgroup-harmonyosnext

Dry run (supply required parameters first)

agc pms getproductgroup-harmonyosnext --invoke --dry-run=true --body body.json

Read endpoint reference ↗

GET查询商品详情getproductinfo-android/api/pms/product-price-service/v1/manage/product

此接口用于商品详情查询，根据productNo和appId唯一查询一个商品信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Inspect definition

agc pms getproductinfo-android --pretty

Local REST definition

/api/v1/pms/endpoints/getproductinfo-android

Dry run (supply required parameters first)

agc pms getproductinfo-android --invoke --dry-run=true

Read endpoint reference ↗

GET查询商品详情getproductinfo-harmonyosnext/api/pms/product-price-service/v2/manage/product

此接口用于商品详情查询，根据productNo和appId唯一查询一个商品信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Inspect definition

agc pms getproductinfo-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/getproductinfo-harmonyosnext

Dry run (supply required parameters first)

agc pms getproductinfo-harmonyosnext --invoke --dry-run=true

Read endpoint reference ↗

GET查询商品促销详情getpromotioninfo-android/api/pms/product-price-service/v1/manage/product/promotion

此接口用于查询商品促销信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Inspect definition

agc pms getpromotioninfo-android --pretty

Local REST definition

/api/v1/pms/endpoints/getpromotioninfo-android

Dry run (supply required parameters first)

agc pms getpromotioninfo-android --invoke --dry-run=true

Read endpoint reference ↗

GET查询商品促销详情getpromotioninfo-harmonyosnext/api/pms/product-price-service/v2/manage/product/promotion

此接口用于查询商品促销信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Inspect definition

agc pms getpromotioninfo-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/getpromotioninfo-harmonyosnext

Dry run (supply required parameters first)

agc pms getpromotioninfo-harmonyosnext --invoke --dry-run=true

Read endpoint reference ↗

GET查询是否有在线商品isproductactive-android/api/pms/product-price-service/v1/manage/product/check

此接口用于根据AppId查询是否有激活的商品。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Inspect definition

agc pms isproductactive-android --pretty

Local REST definition

/api/v1/pms/endpoints/isproductactive-android

Dry run (supply required parameters first)

agc pms isproductactive-android --invoke --dry-run=true

Read endpoint reference ↗

GET查询是否有在线商品isproductactive-harmonyosnext/api/pms/product-price-service/v2/manage/product/check

此接口用于根据AppId查询是否有激活的商品。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Inspect definition

agc pms isproductactive-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/isproductactive-harmonyosnext

Dry run (supply required parameters first)

agc pms isproductactive-harmonyosnext --invoke --dry-run=true

Read endpoint reference ↗

PUT更新商品订阅分组等级信息levelgroup-harmonyosnext/api/pms/product-price-service/v2/manage/product/group/level

此接口用于更新商品订阅分组等级信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms levelgroup-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/levelgroup-harmonyosnext

Dry run (supply required parameters first)

agc pms levelgroup-harmonyosnext --invoke --dry-run=true --body body.json

Read endpoint reference ↗

POST上传资源resourcemanage-harmonyosnext/api/pms/product-price-service/v2/manage/resource

此接口用于提交上传资源。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms resourcemanage-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/resourcemanage-harmonyosnext

Dry run (supply required parameters first)

agc pms resourcemanage-harmonyosnext --invoke --dry-run=true --body body.json

Read endpoint reference ↗

POST提交商品审核reviewproduct-harmonyosnext/api/pms/product-price-service/v2/manage/product/review

此接口用于提交商品审核。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms reviewproduct-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/reviewproduct-harmonyosnext

Dry run (supply required parameters first)

agc pms reviewproduct-harmonyosnext --invoke --dry-run=true --body body.json

Read endpoint reference ↗

PUT更新商品信息updateproduct-android/api/pms/product-price-service/v1/manage/product

此接口用于更新商品定义信息，包含商品价格，展示语言和商品状态。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms updateproduct-android --pretty

Local REST definition

/api/v1/pms/endpoints/updateproduct-android

Dry run (supply required parameters first)

agc pms updateproduct-android --invoke --dry-run=true --body body.json

Read endpoint reference ↗

PUT更新商品信息updateproduct-harmonyosnext/api/pms/product-price-service/v2/manage/product

此接口用于更新商品定义信息，包含商品价格，展示语言和商品状态。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms updateproduct-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/updateproduct-harmonyosnext

Dry run (supply required parameters first)

agc pms updateproduct-harmonyosnext --invoke --dry-run=true --body body.json

Read endpoint reference ↗

PUT更新商品订阅分组信息updateproductgroup-android/api/pms/product-price-service/v1/manage/product/group

此接口用于更新商品订阅分组信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms updateproductgroup-android --pretty

Local REST definition

/api/v1/pms/endpoints/updateproductgroup-android

Dry run (supply required parameters first)

agc pms updateproductgroup-android --invoke --dry-run=true --body body.json

Read endpoint reference ↗

PUT更新商品订阅分组信息updateproductgroup-harmonyosnext/api/pms/product-price-service/v2/manage/product/group

此接口用于更新商品订阅分组信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms updateproductgroup-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/updateproductgroup-harmonyosnext

Dry run (supply required parameters first)

agc pms updateproductgroup-harmonyosnext --invoke --dry-run=true --body body.json

Read endpoint reference ↗

PUT更新商品促销信息updatepromotion-android/api/pms/product-price-service/v1/manage/product/promotion

此接口用于更新商品促销信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms updatepromotion-android --pretty

Local REST definition

/api/v1/pms/endpoints/updatepromotion-android

Dry run (supply required parameters first)

agc pms updatepromotion-android --invoke --dry-run=true --body body.json

Read endpoint reference ↗

PUT更新商品促销信息updatepromotion-harmonyosnext/api/pms/product-price-service/v2/manage/product/promotion

此接口用于更新商品促销信息。

Developer-to-Huawei API

Registered parameters
Parameter	Location	Required	Type	Description

Parameters are not listed in the registry. See the reference.

Request body: json

Inspect definition

agc pms updatepromotion-harmonyosnext --pretty

Local REST definition

/api/v1/pms/endpoints/updatepromotion-harmonyosnext

Dry run (supply required parameters first)

agc pms updatepromotion-harmonyosnext --invoke --dry-run=true --body body.json

Read endpoint reference ↗

What is agc-cli, and who is it for?

agc-cli is an open-source Go command-line tool for Huawei AppGallery Connect, maintained by Createitv. Its installed command is agc. It organizes API discovery, credential profiles, request previews, and API invocation into reusable commands for HarmonyOS and Huawei app developers who manage app metadata, testers, products, and reports.

Project and guides: GitHub · Usage guide · Issues

Frequently asked questions

Is agc-cli an official Huawei tool?

No. agc-cli is an independent open-source project maintained by Createitv under the MIT license. It organizes endpoints using Huawei AppGallery Connect API references and is not an official Huawei product or support service.

How do I install agc-cli on macOS, Windows, or Linux?

On macOS, run brew tap createitv/tap, then brew install agc-cli. On Windows, run scoop bucket add createitv https://github.com/Createitv/scoop-bucket, then scoop install agc-cli. On Linux, download a binary for your architecture from GitHub Releases. Run agc version to verify installation.

Is agc-cli free, and do I need an account?

agc-cli is free to use and modify under the MIT license. Calling Huawei APIs requires your own AppGallery Connect account, credentials, and permissions. Huawei service pricing and limits remain subject to Huawei terms. Browsing the endpoint reference or inspecting CLI definitions does not require login.

How do I query app information for the first time?

Save credentials with agc auth login --service-account-file ~/.agc/service-account.json --name production, then bind the project with agc init --app-id YOUR_APP_ID --default-profile production. Preview with agc publishing app-info-query --invoke --query appId=YOUR_APP_ID --query lang=en-US. Add --dry-run=false after checking the request. Supply a client_id header explicitly when required.

Are all 156 endpoints production-verified?

No. The registry contains 156 entries across 13 API families; this is registry coverage, not production verification of every endpoint. Registered parameters and command surfaces are shown here. Consult each endpoint reference for full request and response schemas, permissions, and business prerequisites.

Does the default dry run change my app?

No. Endpoint commands with --invoke preview the request without sending it by default. Real invocation requires --dry-run=false. Check the target app, credential profile, and parameters before executing.

Can I use agc-cli with scripts or AI agents?

Yes. JSON output supports script processing. agc capabilities and agc endpoints expose discovery; agc web-server provides local REST routes, and agc openapi exports the contract. Command templates support navigation but do not replace business-state checks or review decisions.

Does a project profile fill all endpoint parameters automatically?

A project configuration can select its default credential profile, with --profile for explicit overrides. App IDs, languages, headers, and request bodies still need to be supplied according to each endpoint. Keep Service Account private keys and credential files out of Git.

Browse the complete API reference by family

Content updated: 2026-10-07

Quick start

Three commands to a bound, inspectable workspace.

Use placeholders for your AppGallery Connect values. The second command is what makes the profile automatic for this project.

Save a credential profile

Service Account is the preferred route. Secrets stay in ~/.agc/credentials.json with restricted permissions.

$ agc auth login --service-account-file ~/.agc/service-account.json --name production

Bind it to the project

Save project metadata and choose a default credential profile. Supply endpoint parameters explicitly when invoking APIs.

$ agc init --app-id <app-id> --project-id <project-id> --package-name com.example.app --default-profile production

Inspect before invoking

Endpoint commands are dry-run first. Review the exact method and URL, then opt into the real request.

$ agc publishing app-info-query --invoke --query appId=<app-id> --dry-run=false

Local command center

The browser is a window into the same registry.

Start the local REST server when you want live capability data. Without it, this site stays useful as a complete reference surface.

agc web-server --addr :8421

GET/api/v1/capabilitiesfamilies + affordances

GET/api/v1/endpointsall interface entries

GET/api/v1/openapi.jsonmachine-readable contract

POST/api/v1/:family/endpoints/:id/invokedry-run by default