Manage your apps in App Store Connect
app-store-connect apps [-h] [--log-stream STREAM] [--no-color] [--version] [-s] [-v]
[--log-api-calls]
[--api-unauthorized-retries UNAUTHORIZED_REQUEST_RETRIES]
[--api-server-error-retries SERVER_ERROR_RETRIES]
[--disable-jwt-cache]
[--json]
[--issuer-id ISSUER_ID]
[--key-id KEY_IDENTIFIER]
[--private-key PRIVATE_KEY]
[--certificates-dir CERTIFICATES_DIRECTORY]
[--profiles-dir PROFILES_DIRECTORY]
ACTION
Turn on logging for App Store Connect API HTTP requests
Specify how many times the App Store Connect API request should be retried in case the called request fails due to an authentication error (401 Unauthorized response from the server). In case of the above authentication error, the request is retried usinga new JSON Web Token as many times until the number of retries is exhausted. If not given, the value will be checked from the environment variable APP_STORE_CONNECT_API_UNAUTHORIZED_RETRIES
. [Default: 3]
Specify how many times the App Store Connect API request should be retried in case the called request fails due to a server error (response with status code 5xx). In case of server error, the request is retried until the number of retries is exhausted. If not given, the value will be checked from the environment variable APP_STORE_CONNECT_API_SERVER_ERROR_RETRIES
. [Default: 3]
Turn off caching App Store Connect JSON Web Tokens to disk. By default generated tokens are cached to disk to be reused between separate processes, which can can reduce number of false positive authentication errors from App Store Connect API. If not given, the value will be checked from the environment variable APP_STORE_CONNECT_DISABLE_JWT_CACHE
.
Whether to show the resource in JSON format
App Store Connect API Key Issuer ID. Identifies the issuer who created the authentication token. Learn more at https://developer.apple.com/documentation/appstoreconnectapi/creating_api_keys_for_app_store_connect_api. If not given, the value will be checked from the environment variable APP_STORE_CONNECT_ISSUER_ID
. Alternatively to entering ISSUER_ID
in plaintext, it may also be specified using the @env:
prefix followed by an environment variable name, or the @file:
prefix followed by a path to the file containing the value. Example: @env:<variable>
uses the value in the environment variable named <variable>
, and @file:<file_path>
uses the value from the file at <file_path>
.
App Store Connect API Key ID. Learn more at https://developer.apple.com/documentation/appstoreconnectapi/creating_api_keys_for_app_store_connect_api. If not given, the value will be checked from the environment variable APP_STORE_CONNECT_KEY_IDENTIFIER
. Alternatively to entering KEY_IDENTIFIER
in plaintext, it may also be specified using the @env:
prefix followed by an environment variable name, or the @file:
prefix followed by a path to the file containing the value. Example: @env:<variable>
uses the value in the environment variable named <variable>
, and @file:<file_path>
uses the value from the file at <file_path>
.
App Store Connect API private key used for JWT authentication to communicate with Apple services. Learn more at https://developer.apple.com/documentation/appstoreconnectapi/creating_api_keys_for_app_store_connect_api. If not provided, the key will be searched from the following directories in sequence for a private key file with the name AuthKey_<key_identifier>.p8
: private_keys, ~/private_keys, ~/.private_keys, ~/.appstoreconnect/private_keys, where <key_identifier> is the value of --key-id
. If not given, the value will be checked from the environment variable APP_STORE_CONNECT_PRIVATE_KEY
. Alternatively to entering PRIVATE_KEY
in plaintext, it may also be specified using the @env:
prefix followed by an environment variable name, or the @file:
prefix followed by a path to the file containing the value. Example: @env:<variable>
uses the value in the environment variable named <variable>
, and @file:<file_path>
uses the value from the file at <file_path>
.
Directory where the code signing certificates will be saved. Default: $HOME/Library/MobileDevice/Certificates
Directory where the provisioning profiles will be saved. Default: $HOME/Library/MobileDevice/Provisioning Profiles
show this help message and exit
Log output stream. Default stderr
Do not use ANSI colors to format terminal output
Show tool version and exit
Disable log output for commands
Enable verbose logging for commands
Action | Description |
---|---|
cancel-review-submissions |
Find and cancel review submissions in App Store Connect for the given application |
expire-builds |
Expire all application builds except the given build(s) |
expire-build-submitted-for-review |
Expire application build that is currently waiting for review, or is currently in review in TestFlight |
get |
Get information about a specific app |
builds |
Get a list of builds associated with a specific app matching given constrains |
pre-release-versions |
Get a list of prerelease versions associated with a specific app |
app-store-versions |
Get a list of App Store versions associated with a specific app |
list |
Find and list apps added in App Store Connect |
list-review-submissions |
Find and list review submissions in App Store Connect for the given application |