[GH-ISSUE #233] Complete Xcode Cloud CLI coverage for remaining endpoints #71

New issue

Closed

opened 2026-02-26 21:33:09 +03:00 by kerem · 1 comment

kerem commented 2026-02-26 21:33:09 +03:00

Owner

Copy link

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

Overview

The CLI now covers workflows, build runs, actions, artifacts, test results, and issues. The remaining Xcode Cloud endpoints in the OpenAPI spec are not surfaced yet. This issue tracks adding those endpoints (read-only and workflow mutations) so the CLI can fully cover Xcode Cloud.

Docs (API)

• CiProducts list: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-ciproducts

• CiProducts get: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-ciproducts-id

• CiProducts app: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-ciproducts-id-app

• CiProducts build runs: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-ciproducts-id-buildruns

• CiProducts workflows: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-ciproducts-id-workflows

• CiProducts primary repos: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-ciproducts-id-primaryrepositories

• CiProducts additional repos: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-ciproducts-id-additionalrepositories

• CiProducts delete: https://sosumi.ai/documentation/appstoreconnectapi/delete-v1-ciproducts-id

• CiWorkflows get: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-ciworkflows-id

• CiWorkflows build runs: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-ciworkflows-id-buildruns

• CiWorkflows repository: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-ciworkflows-id-repository

• CiWorkflows create: https://sosumi.ai/documentation/appstoreconnectapi/post-v1-ciworkflows

• CiWorkflows update: https://sosumi.ai/documentation/appstoreconnectapi/patch-v1-ciworkflows-id

• CiWorkflows delete: https://sosumi.ai/documentation/appstoreconnectapi/delete-v1-ciworkflows-id

• CiBuildRuns builds: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-cibuildruns-id-builds

• CiBuildActions get: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-cibuildactions-id

• CiBuildActions build run: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-cibuildactions-id-buildrun

• CiMacOsVersions list: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-cimacosversions

• CiMacOsVersions get: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-cimacosversions-id

• CiMacOsVersions xcode versions: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-cimacosversions-id-xcodeversions

• CiXcodeVersions list: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-cixcodeversions

• CiXcodeVersions get: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-cixcodeversions-id

• CiXcodeVersions macOS versions: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-cixcodeversions-id-macosversions

Scope (Endpoints)

Read-only:

• GET /v1/ciProducts
• GET /v1/ciProducts/{id}
• GET /v1/ciProducts/{id}/app
• GET /v1/ciProducts/{id}/buildRuns
• GET /v1/ciProducts/{id}/workflows
• GET /v1/ciProducts/{id}/primaryRepositories
• GET /v1/ciProducts/{id}/additionalRepositories
• GET /v1/ciWorkflows/{id}
• GET /v1/ciWorkflows/{id}/buildRuns
• GET /v1/ciWorkflows/{id}/repository
• GET /v1/ciBuildRuns/{id}/builds
• GET /v1/ciBuildActions/{id}
• GET /v1/ciBuildActions/{id}/buildRun
• GET /v1/ciMacOsVersions
• GET /v1/ciMacOsVersions/{id}
• GET /v1/ciMacOsVersions/{id}/xcodeVersions
• GET /v1/ciXcodeVersions
• GET /v1/ciXcodeVersions/{id}
• GET /v1/ciXcodeVersions/{id}/macOsVersions
• Optional: relationship endpoints for linkages (if useful for lightweight list)

Mutations:

• POST /v1/ciWorkflows
• PATCH /v1/ciWorkflows/{id}
• DELETE /v1/ciWorkflows/{id}
• DELETE /v1/ciProducts/{id}

Proposed CLI

All under xcode-cloud:

asc xcode-cloud products list [--app APP_ID]
asc xcode-cloud products get --id PRODUCT_ID

asc xcode-cloud workflows get --id WORKFLOW_ID
asc xcode-cloud workflows repository --id WORKFLOW_ID

asc xcode-cloud build-runs builds --run-id BUILD_RUN_ID
asc xcode-cloud actions get --id ACTION_ID
asc xcode-cloud actions build-run --id ACTION_ID

asc xcode-cloud macos-versions list
asc xcode-cloud macos-versions get --id MACOS_VERSION_ID
asc xcode-cloud macos-versions xcode-versions --id MACOS_VERSION_ID

asc xcode-cloud xcode-versions list
asc xcode-cloud xcode-versions get --id XCODE_VERSION_ID
asc xcode-cloud xcode-versions macos-versions --id XCODE_VERSION_ID

Mutations (separate subcommands):

asc xcode-cloud workflows create --file ./workflow.json
asc xcode-cloud workflows update --id WORKFLOW_ID --file ./workflow.json
asc xcode-cloud workflows delete --id WORKFLOW_ID --confirm

asc xcode-cloud products delete --id PRODUCT_ID --confirm

Flags

Common:

• --output json|table|markdown
• --pretty
• --limit, --next, --paginate

Mutations:

• --confirm required for deletes
• --file for create/update (raw JSON request body)

Output

• JSON (minified) by default
• Table/markdown for list/get
• Builds list should surface build number, version, processing state, uploaded date (if available)
• Versions list should surface version name and related xcode/macos versions
• Products list should surface product name, bundle ID, and created date (if available)

Acceptance Criteria

• asc xcode-cloud products|workflows|actions|build-runs|macos-versions|xcode-versions --help available
• Read-only endpoints work with pagination
• Get endpoints return details for a single item
• Create/update/delete require --confirm (delete) and --file (create/update)
• JSON/table/markdown output where applicable

Tests

• CLI validation tests (missing --id / invalid flags)
• Client tests for list/get endpoints and pagination
• Mutation tests for workflow create/update/delete (request shape + validation)
• Output tests for table/markdown

Manual Test Plan (using real apps)

1. List products and workflows:
   • asc xcode-cloud products list --app APP_ID
   • asc xcode-cloud products get --id PRODUCT_ID
2. Read workflow metadata:
   • asc xcode-cloud workflows get --id WORKFLOW_ID
   • asc xcode-cloud workflows repository --id WORKFLOW_ID
3. Build run builds:
   • asc xcode-cloud build-runs builds --run-id BUILD_RUN_ID
4. Build action get/build-run:
   • asc xcode-cloud actions get --id ACTION_ID
   • asc xcode-cloud actions build-run --id ACTION_ID
5. List versions:
   • asc xcode-cloud macos-versions list
   • asc xcode-cloud xcode-versions list

Implementation Notes

• Add CiMacOsVersion/CiXcodeVersion types and responses in internal/asc/xcode_cloud.go.
• Add client methods for all endpoints above.
• Add output helpers in internal/asc/xcode_cloud_output.go.
• Add new subcommands in cmd/xcode_cloud.go (or split into new files), register under xcode-cloud.
• Use explicit flags only; no interactive prompts (use --confirm for destructive operations).

Originally created by @rudrankriyam on GitHub (Jan 27, 2026). Original GitHub issue: https://github.com/rudrankriyam/App-Store-Connect-CLI/issues/233 # Overview The CLI now covers workflows, build runs, actions, artifacts, test results, and issues. The remaining Xcode Cloud endpoints in the OpenAPI spec are not surfaced yet. This issue tracks adding those endpoints (read-only and workflow mutations) so the CLI can fully cover Xcode Cloud. # Docs (API) - CiProducts list: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-ciproducts - CiProducts get: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-ciproducts-_id_ - CiProducts app: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-ciproducts-_id_-app - CiProducts build runs: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-ciproducts-_id_-buildruns - CiProducts workflows: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-ciproducts-_id_-workflows - CiProducts primary repos: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-ciproducts-_id_-primaryrepositories - CiProducts additional repos: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-ciproducts-_id_-additionalrepositories - CiProducts delete: https://sosumi.ai/documentation/appstoreconnectapi/delete-v1-ciproducts-_id_ - CiWorkflows get: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-ciworkflows-_id_ - CiWorkflows build runs: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-ciworkflows-_id_-buildruns - CiWorkflows repository: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-ciworkflows-_id_-repository - CiWorkflows create: https://sosumi.ai/documentation/appstoreconnectapi/post-v1-ciworkflows - CiWorkflows update: https://sosumi.ai/documentation/appstoreconnectapi/patch-v1-ciworkflows-_id_ - CiWorkflows delete: https://sosumi.ai/documentation/appstoreconnectapi/delete-v1-ciworkflows-_id_ - CiBuildRuns builds: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-cibuildruns-_id_-builds - CiBuildActions get: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-cibuildactions-_id_ - CiBuildActions build run: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-cibuildactions-_id_-buildrun - CiMacOsVersions list: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-cimacosversions - CiMacOsVersions get: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-cimacosversions-_id_ - CiMacOsVersions xcode versions: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-cimacosversions-_id_-xcodeversions - CiXcodeVersions list: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-cixcodeversions - CiXcodeVersions get: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-cixcodeversions-_id_ - CiXcodeVersions macOS versions: https://sosumi.ai/documentation/appstoreconnectapi/get-v1-cixcodeversions-_id_-macosversions # Scope (Endpoints) Read-only: - `GET /v1/ciProducts` - `GET /v1/ciProducts/{id}` - `GET /v1/ciProducts/{id}/app` - `GET /v1/ciProducts/{id}/buildRuns` - `GET /v1/ciProducts/{id}/workflows` - `GET /v1/ciProducts/{id}/primaryRepositories` - `GET /v1/ciProducts/{id}/additionalRepositories` - `GET /v1/ciWorkflows/{id}` - `GET /v1/ciWorkflows/{id}/buildRuns` - `GET /v1/ciWorkflows/{id}/repository` - `GET /v1/ciBuildRuns/{id}/builds` - `GET /v1/ciBuildActions/{id}` - `GET /v1/ciBuildActions/{id}/buildRun` - `GET /v1/ciMacOsVersions` - `GET /v1/ciMacOsVersions/{id}` - `GET /v1/ciMacOsVersions/{id}/xcodeVersions` - `GET /v1/ciXcodeVersions` - `GET /v1/ciXcodeVersions/{id}` - `GET /v1/ciXcodeVersions/{id}/macOsVersions` - Optional: relationship endpoints for linkages (if useful for lightweight list) Mutations: - `POST /v1/ciWorkflows` - `PATCH /v1/ciWorkflows/{id}` - `DELETE /v1/ciWorkflows/{id}` - `DELETE /v1/ciProducts/{id}` # Proposed CLI All under `xcode-cloud`: ``` asc xcode-cloud products list [--app APP_ID] asc xcode-cloud products get --id PRODUCT_ID asc xcode-cloud workflows get --id WORKFLOW_ID asc xcode-cloud workflows repository --id WORKFLOW_ID asc xcode-cloud build-runs builds --run-id BUILD_RUN_ID asc xcode-cloud actions get --id ACTION_ID asc xcode-cloud actions build-run --id ACTION_ID asc xcode-cloud macos-versions list asc xcode-cloud macos-versions get --id MACOS_VERSION_ID asc xcode-cloud macos-versions xcode-versions --id MACOS_VERSION_ID asc xcode-cloud xcode-versions list asc xcode-cloud xcode-versions get --id XCODE_VERSION_ID asc xcode-cloud xcode-versions macos-versions --id XCODE_VERSION_ID ``` Mutations (separate subcommands): ``` asc xcode-cloud workflows create --file ./workflow.json asc xcode-cloud workflows update --id WORKFLOW_ID --file ./workflow.json asc xcode-cloud workflows delete --id WORKFLOW_ID --confirm asc xcode-cloud products delete --id PRODUCT_ID --confirm ``` # Flags Common: - `--output json|table|markdown` - `--pretty` - `--limit`, `--next`, `--paginate` Mutations: - `--confirm` required for deletes - `--file` for create/update (raw JSON request body) # Output - JSON (minified) by default - Table/markdown for list/get - Builds list should surface build number, version, processing state, uploaded date (if available) - Versions list should surface version name and related xcode/macos versions - Products list should surface product name, bundle ID, and created date (if available) # Acceptance Criteria - [ ] `asc xcode-cloud products|workflows|actions|build-runs|macos-versions|xcode-versions --help` available - [ ] Read-only endpoints work with pagination - [ ] Get endpoints return details for a single item - [ ] Create/update/delete require `--confirm` (delete) and `--file` (create/update) - [ ] JSON/table/markdown output where applicable # Tests - CLI validation tests (missing --id / invalid flags) - Client tests for list/get endpoints and pagination - Mutation tests for workflow create/update/delete (request shape + validation) - Output tests for table/markdown # Manual Test Plan (using real apps) 1) List products and workflows: - `asc xcode-cloud products list --app APP_ID` - `asc xcode-cloud products get --id PRODUCT_ID` 2) Read workflow metadata: - `asc xcode-cloud workflows get --id WORKFLOW_ID` - `asc xcode-cloud workflows repository --id WORKFLOW_ID` 3) Build run builds: - `asc xcode-cloud build-runs builds --run-id BUILD_RUN_ID` 4) Build action get/build-run: - `asc xcode-cloud actions get --id ACTION_ID` - `asc xcode-cloud actions build-run --id ACTION_ID` 5) List versions: - `asc xcode-cloud macos-versions list` - `asc xcode-cloud xcode-versions list` # Implementation Notes - Add CiMacOsVersion/CiXcodeVersion types and responses in `internal/asc/xcode_cloud.go`. - Add client methods for all endpoints above. - Add output helpers in `internal/asc/xcode_cloud_output.go`. - Add new subcommands in `cmd/xcode_cloud.go` (or split into new files), register under `xcode-cloud`. - Use explicit flags only; no interactive prompts (use `--confirm` for destructive operations).

kerem closed this issue 2026-02-26 21:33:10 +03:00

kerem commented 2026-02-26 21:33:11 +03:00

Author

Owner

Copy link

@rudrankriyam commented on GitHub (Jan 27, 2026):

Closed as fixed by #237. PR: https://github.com/rudrankriyam/App-Store-Connect-CLI/pull/237

<!-- gh-comment-id:3808159117 --> @rudrankriyam commented on GitHub (Jan 27, 2026): Closed as fixed by #237. PR: https://github.com/rudrankriyam/App-Store-Connect-CLI/pull/237

kerem referenced this issue 2026-02-26 21:34:29 +03:00

[PR #119] [MERGED] Bundle ID capabilities #299

Sign in to join this conversation.

No Branch/Tag specified

Branches Tags

main

1.2.6

1.2.5

1.2.4

1.2.3

1.2.2

1.2.1

1.2.0

1.1.1

1.1.0

1.0.1

1.0.0

0.49.1

0.49.0

0.48.1

0.48.0

0.47.1

0.47.0

0.46.2

0.46.1

0.46.0

0.45.4

0.45.3

0.45.2

0.45.1

0.45.0

0.44.2

0.44.1

0.44.0

0.43.0

0.42.0

0.41.4

0.41.3

0.41.2

0.41.1

0.41.0

0.40.1

0.40.0

0.39.1

0.39.0

0.38.3

0.38.2

0.38.1

0.38.0

0.37.3

0.37.2

0.37.1

0.37.0

0.36.3

0.36.2

0.36.1

0.36.0

0.35.3

0.35.2

0.35.1

0.35.0

0.34.1

0.34.0

0.33.2

0.33.1

0.33.0

0.32.0

0.31.3

0.31.2

0.31.1

0.31.0

0.30.0

0.29.3

0.29.2

0.29.1

0.29.0

0.28.14

0.28.13

0.28.12

0.28.11

0.28.10

0.28.9

0.28.8

0.28.7

0.28.6

0.28.5

0.28.4

0.28.3

0.28.2

0.28.1

0.28.0

0.27.0

0.26.4

0.26.3

0.26.2

0.26.1

0.26.0

0.25.4

0.25.3

0.25.1

0.25.0

0.24.3

0.24.2

0.24.1

0.24.0

0.23.5

0.23.4

0.23.3

0.23.2

0.23.1

0.23.0

0.22.1

0.22.0

0.21.0

0.20.2

0.20.1

0.20.0

0.19.3

0.19.2

0.19.1

0.19.0

0.18.2

0.18.1

0.18.0

0.17.0

0.16.0

0.15.0

0.14.0

0.13.0

0.12.4

0.12.3

0.12.2

0.12.1

0.12.0

0.11.0

0.10.2

0.10.1

0.10.0

0.9.0

0.8.1

0.8.0

0.7.0

0.6.0

0.5.0

0.3.1

0.3.0

0.2.0

0.1.6

0.1.5

0.1.4

0.1.3

0.1.2

0.1.1

0.1.0

Labels

Clear labels   

bug

  

bug

  

documentation

  

enhancement

  

pull-request

Mirrored from GitHub Pull Request

No labels

bug

bug

documentation

enhancement

pull-request

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

starred/App-Store-Connect-CLI#71

No description provided.