[GH-ISSUE #201] Add App Tags CLI support #62

New issue

Closed

opened 2026-02-26 21:33:06 +03:00 by kerem · 0 comments

kerem commented

2026-02-26 21:33:06 +03:00

Owner

Originally created by @rudrankriyam on GitHub (Jan 26, 2026).
Original GitHub issue: https://github.com/rudrankriyam/App-Store-Connect-CLI/issues/201

Overview

Add CLI support for App Tags so users can view Apple‑assigned tags for an app and opt out of tags that are not representative.

Docs (API)

App tags: https://sosumi.ai/documentation/appstoreconnectapi/app-tags
AppTag object: https://sosumi.ai/documentation/appstoreconnectapi/apptag
Update request: https://sosumi.ai/documentation/appstoreconnectapi/apptagupdaterequest

Scope (Endpoints)

From the docs:

GET /v1/apps/{id}/appTags (list tags for an app)
GET /v1/apps/{id}/relationships/appTags
GET /v1/appTags/{id}/territories
GET /v1/appTags/{id}/relationships/territories
PATCH /v1/appTags/{id} (opt out of a tag)

Note: App tags are Apple‑created; there is no public create/delete for tags.

Proposed CLI

Top‑level group: asc app-tags <subcommand> [flags]

Subcommands:

app-tags list --app APP_ID
app-tags territories --tag-id TAG_ID
app-tags opt-out --tag-id TAG_ID --confirm
(Optional if GET /v1/appTags/{id} exists) app-tags get --tag-id TAG_ID

Flags

Common:

--output json|table|markdown
--pretty

Opt‑out:

--confirm required

Output

JSON (minified) by default
Table/markdown for list/get

Acceptance Criteria

asc app-tags --help available
List tags for an app
List territories for a tag
Opt out of a tag via PATCH
Delete/confirm guard for opt‑out
JSON/table/markdown output

Tests

CLI validation tests (missing --app / --tag-id / --confirm)
Client tests for list app tags, list territories, patch opt‑out
Output tests for table/markdown

Manual Test Plan (using real apps)

asc apps --paginate → APP_ID
List tags:
- asc app-tags list --app APP_ID
Pick a tag ID from output:
- asc app-tags territories --tag-id TAG_ID
Opt out:
- asc app-tags opt-out --tag-id TAG_ID --confirm
Verify in UI: App Store Connect → App Information → App Tags

Implementation Notes

Add cmd/app_tags.go and internal/asc/client_app_tags.go
Add output helper for tags and territories
Register in cmd/root.go

Originally created by @rudrankriyam on GitHub (Jan 26, 2026). Original GitHub issue: https://github.com/rudrankriyam/App-Store-Connect-CLI/issues/201 # Overview Add CLI support for **App Tags** so users can view Apple‑assigned tags for an app and opt out of tags that are not representative. # Docs (API) - App tags: https://sosumi.ai/documentation/appstoreconnectapi/app-tags - AppTag object: https://sosumi.ai/documentation/appstoreconnectapi/apptag - Update request: https://sosumi.ai/documentation/appstoreconnectapi/apptagupdaterequest # Scope (Endpoints) From the docs: - `GET /v1/apps/{id}/appTags` (list tags for an app) - `GET /v1/apps/{id}/relationships/appTags` - `GET /v1/appTags/{id}/territories` - `GET /v1/appTags/{id}/relationships/territories` - `PATCH /v1/appTags/{id}` (opt out of a tag) **Note:** App tags are Apple‑created; there is no public create/delete for tags. # Proposed CLI Top‑level group: `asc app-tags <subcommand> [flags]` Subcommands: - `app-tags list --app APP_ID` - `app-tags territories --tag-id TAG_ID` - `app-tags opt-out --tag-id TAG_ID --confirm` - (Optional if GET /v1/appTags/{id} exists) `app-tags get --tag-id TAG_ID` # Flags Common: - `--output json|table|markdown` - `--pretty` Opt‑out: - `--confirm` required # Output - JSON (minified) by default - Table/markdown for list/get # Acceptance Criteria - [ ] `asc app-tags --help` available - [ ] List tags for an app - [ ] List territories for a tag - [ ] Opt out of a tag via PATCH - [ ] Delete/confirm guard for opt‑out - [ ] JSON/table/markdown output # Tests - CLI validation tests (missing --app / --tag-id / --confirm) - Client tests for list app tags, list territories, patch opt‑out - Output tests for table/markdown # Manual Test Plan (using real apps) 1) `asc apps --paginate` → `APP_ID` 2) List tags: - `asc app-tags list --app APP_ID` 3) Pick a tag ID from output: - `asc app-tags territories --tag-id TAG_ID` 4) Opt out: - `asc app-tags opt-out --tag-id TAG_ID --confirm` 5) Verify in UI: App Store Connect → App Information → App Tags # Implementation Notes - Add `cmd/app_tags.go` and `internal/asc/client_app_tags.go` - Add output helper for tags and territories - Register in `cmd/root.go`