メインコンテンツまでスキップ

アプリの追加と接続

APIを通じてリリースを管理する前に、アプリをRelease Managementに追加し、ストアに接続する必要があります。

AppsサブAPIのベースURL: https://api.bitrise.io/release-management/v2/apps/v1。エンドポイント、パラメータ、スキーマの全一覧はApps API リファレンスをご覧ください。

新しいアプリを追加するClick to copy link​

EndpointFunctionRequired role
POST /新しいアプリを追加します。リリースマネージャー
GET /workspace内のすべてのアプリを一覧表示します。制限なし
GET /{id}特定のアプリの詳細を取得します。制限なし
DELETE /{id}Release Managementからアプリを削除します。リリースマネージャー

アプリを追加するには、必須フィールドを指定してPOST /を呼び出します。

  • platform: アプリのプラットフォーム: iosまたはandroid。
  • store_app_id: アプリのストア識別子。iOSの場合: App Store Connectの数値アプリID。Androidの場合: package name（例: com.example.myapp）。
  • workspace_slug: アプリを所有するBitrise workspaceのスラッグ。
  • store_credential_id: workspaceで設定したAppleまたはGoogleサービス認証情報の数値整数ID。アプリをすぐにストアに接続する場合に必要です。これをスキップして後で接続する場合は、代わりにmanual_connection: trueを設定してください。
curl -X POST "https://api.bitrise.io/release-management/v2/apps/v1/" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "ios",
    "store_app_id": "1234567890",
    "workspace_slug": "YOUR_WORKSPACE_SLUG",
    "store_app_name": "My iOS App",
    "store_credential_id": YOUR_APPLE_CREDENTIAL_ID,
    "framework": "native_ios"
  }'

レスポンスには、新しいアプリのidが含まれます。

{
  "id": "YOUR_APP_ID",
  "created_at": "2026-01-01T00:00:00.000Z",
  "platform": "android",
  "project_id": "YOUR_PROJECT_ID",
  "workspace_slug": "YOUR_WORKSPACE_SLUG",
  "icon_id": null,
  "icon_url": null,
  "app_name": "My Android App",
  "current_user_release_management_admin": false,
  "framework": "native_android",
  "latest_version": null,
  "latest_version_date": null,
  "latest_build_version": "",
  "latest_build_version_code": "",
  "license": "basic",
  "store_app_id": "com.example.myapp",
  "store_connected": true,
  "store_credential_id": 12345
}

この値を保存してください。このアプリに対する以降のすべてのAPI呼び出しで必要になります。

ストアの認証情報

store_credential_idは、workspaceで設定したAppleまたはGoogleサービス認証情報を指します。認証情報は、Workspace settings > IntegrationsからBitriseで管理できます。

アプリは後でPATCH /{id}を使用してストアに接続できます。

アプリをストアに接続するClick to copy link​

EndpointFunctionRequired role
PATCH /{id}ストア接続を含むapp settingsを更新します。リリースマネージャー

manual_connection: trueでアプリを追加した場合や、ストアの認証情報を更新する必要がある場合は、PATCH /{id}を使用します。

curl -X PATCH "https://api.bitrise.io/release-management/v2/apps/v1/APP_ID" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "connect_to_store": true,
    "store_credential_id": YOUR_CREDENTIAL_ID
  }'

アプリが誤った識別子で最初に登録されていた場合は、PATCH /{id}経由でstore_app_idを更新することもできます。

アプリを一覧表示するClick to copy link​

workspace内のすべてのアプリを一覧表示するには:

curl -X GET "https://api.bitrise.io/release-management/v2/apps/v1/?workspace_slug=YOUR_WORKSPACE_SLUG" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

オプションのクエリパラメータ:

  • platform: iosまたはandroidでフィルタします。
  • project_id: 関連付けられたBitrise CIプロジェクトIDでフィルタします。
  • search: アプリ名で検索します。
  • items_per_page: 1ページあたりの結果数（デフォルト: 10、最大: 50）。
  • page: ページ番号（デフォルト: 1）。

アプリを削除するClick to copy link​

削除は取り消せません

Release Managementからアプリを削除すると、関連するすべてのリリース、アーティファクト、設定が削除されます。この操作は取り消せません。

curl -X DELETE "https://api.bitrise.io/release-management/v2/apps/v1/APP_ID" \
  -H "Authorization: YOUR_ACCESS_TOKEN"

関連情報