Create an App’s Distribution Page

POST https://deploygate.com/api/users/{OWNER_NAME}/platforms/{PLATFORM_TYPE}/apps/{APP_ID}/distributions

---

Path Params

Name	Type	Required	Description
OWNER_NAME	string	true	App owner's user name or group name
PLATFORM_TYPE	string	true	ios or android
APP_ID	string	true	App's package name (Example: com.deploygate.android)

Body

Name	Type	Required	Description
title	string	true	The Distribution Page’s title
revision	int32	false	A number representing the version on the package management screen (Example: # 1) Default: Latest revision
release_note	string	false	The Distribution Page’s release notes Default: Revision's descriptions
active	boolean	false	Enable or disable the Distribution Page Feature Flag. Change by selecting one of these options. true (Enable) false (Disable) Default: true

Example

curl \
  --url "https://deploygate.com/api/users/${OWNER_NAME}/platforms/${PLATFORM_TYPE}/apps/${APP_ID}/distributions" \
  -H "Authorization: Bearer ${API_TOKEN}"  \
  -X POST \
  --form-string "title=${TITLE}" \
  --form-string "revision=${REVISION}" \
  --form-string "release_note=${RELEASE_NOTE}" \
  --form-string "active=${ACTIVE}"

Result 200

{
  "error": false,
  "results": {
    "access_key": "${ACCESS_KEY}",
    "active": true,
    "title": "title of the distribution page",
    "release_note": "release note of the distribution page",
    "release_scope": "${RELEASE_SCOPE}",
    "max_members": 100,
    "updated_at": 1709033626,
    "application": {
      "package_name": "${APP_ID}",
      "os_name": "Android",
      "name": "name of app",
      "version_code": "1",
      "version_name": "1.0",
      "sdk_version": 21,
      "raw_sdk_version": "21",
      "target_sdk_version": 32,
      "signature": "signature",
      "fingerprints": [
        {
          "md5": "md5 hash",
          "sha1": "sha1",
          "sha256": "sha256",
          "max_sdk_version": 2147483647,
          "min_sdk_version": 21
        }
      ],
      "lineages": [],
      "file_size": 1441970,
      "md5": "md5 hash",
      "revision": "${REVISION_NUMBER}",
      "info": "app info",
      "updated_at": 1709000986,
      "revision_url": "https://deploygate.com/organizations/${ORGANIZATION_NAME}/platforms/${PLATFORM_TYPE}/apps/${APP_ID}/binaries/${REVISION_NUMBER}",
      "sdk_abilities": [],
      "labels": {},
      "path": "/organizations/${ORGANIZATION_NAME}/platforms/${PLATFORM_TYPE}/apps/${APP_ID}"
    },
    "url": "https://deploygate.com/distributions/${ACCESS_KEY}"
  }
}

Result 404

{
  "message": "revision not found",
  "because": "revision not found",
  "error": true
}