modify ====== **Update the app store version for a specific app.** ### Usage ```bash app-store-connect app-store-versions modify [-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] [--build-id BUILD_ID_RESOURCE_ID_OPTIONAL] [--copyright COPYRIGHT] [--earliest-release-date EARLIEST_RELEASE_DATE] [--release-type RELEASE_TYPE] [--version-string VERSION_STRING] APP_STORE_VERSION_ID ``` ### Required arguments for action `modify` ##### `APP_STORE_VERSION_ID` UUID value of the App Store Version ### Optional arguments for action `modify` ##### `--build-id=BUILD_ID_RESOURCE_ID_OPTIONAL` Alphanumeric ID value of the Build ##### `--copyright=COPYRIGHT` The name of the person or entity that owns the exclusive rights to your app, preceded by the year the rights were obtained (for example, `2008 Acme Inc.`). Do not provide a URL. ##### `--earliest-release-date=EARLIEST_RELEASE_DATE` Specify earliest return date for scheduled release type (see `--release-type` configuration option). Timezone aware ISO8601 timestamp with hour precision, for example `2021-11-10T14:00:00+00:00`. ##### `--release-type=MANUAL | AFTER_APPROVAL | SCHEDULED` Choose when to release the app. You can either manually release the app at a later date on the App Store Connect website, or the app version can be automatically released right after it has been approved by App Review. ##### `--version-string, --app-store-version=VERSION_STRING` Version of the build published to App Store that identifies an iteration of the bundle. The string can only contain one to three groups of numeric characters (0-9) separated by period in the format [Major].[Minor].[Patch]. For example `3.2.46` ### Optional arguments for command `app-store-connect` ##### `--log-api-calls` Turn on logging for App Store Connect API HTTP requests ##### `--api-unauthorized-retries, -r=UNAUTHORIZED_REQUEST_RETRIES` 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] ##### `--api-server-error-retries=SERVER_ERROR_RETRIES` 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] ##### `--disable-jwt-cache` 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`. ##### `--json` Whether to show the resource in JSON format ##### `--issuer-id=ISSUER_ID` 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:` uses the value in the environment variable named ``, and `@file:` uses the value from the file at ``. ##### `--key-id=KEY_IDENTIFIER` 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:` uses the value in the environment variable named ``, and `@file:` uses the value from the file at ``. ##### `--private-key=PRIVATE_KEY` 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_.p8`: private_keys, ~/private_keys, ~/.private_keys, ~/.appstoreconnect/private_keys, where 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:` uses the value in the environment variable named ``, and `@file:` uses the value from the file at ``. ##### `--certificates-dir=CERTIFICATES_DIRECTORY` Directory where the code signing certificates will be saved. Default: `$HOME/Library/MobileDevice/Certificates` ##### `--profiles-dir=PROFILES_DIRECTORY` Directory where the provisioning profiles will be saved. Default: `$HOME/Library/MobileDevice/Provisioning Profiles` ### Common options ##### `-h, --help` show this help message and exit ##### `--log-stream=stderr | stdout` Log output stream. Default `stderr` ##### `--no-color` Do not use ANSI colors to format terminal output ##### `--version` Show tool version and exit ##### `-s, --silent` Disable log output for commands ##### `-v, --verbose` Enable verbose logging for commands