Knowledge Center
Get familiar with Applivery and explore the features

Upload a Build

The Upload Build request endpoint is intended to upload a new Build (.ipa or .apk binary files) to Applivery.

Definition:
POST https://api.applivery.io/v1/integrations/builds

  • Authentication: required
  • Headers:
    • Content-Type: application/json
    • Authorization: bearer <Your_App_Token>

Param Type Description
build File .ipa or .apk binary file
versionName String Human readable version name for this build. E.g.: RC-1
tags Array Comma separated tags. E.g.: tag1, tag2, tag3
changelog String Build release notes or log of changes E.g.: Bug fixing!.
notifyCollaborators Boolean Notify App and Organization collaborators. E.g.: true
notifyEmployees Boolean Notify App and Organization employees. E.g.: true
notifyMessage String Notification message to send in the email. E.g.: Enjoy the App!
deployer.name String Custom deployer display name. E.g.: Jenkins CI
deployer.info.commitMessage String Git commit message. E.g.: Fixed issue #123
deployer.info.commit String Git commit. E.g.: f52ace0
deployer.info.branch String Git branch. E.g.: develop
deployer.info.tag String Git tag. E.g.: RC-1
deployer.info.triggerTimestamp String CI trigger date/time. E.g.: 1558359012580
deployer.info.buildUrl String CI build URL. E.g.: https://...
deployer.info.ciUrl String CI platform URL. E.g.: https://...
deployer.info.repositoryUrl String Version control repository URL. E.g.: https://...
deployer.info.buildNumber String CI platform build number. E.g.: 73

CURL Request Example

curl 'https://api.applivery.io/v1/integrations/builds' \
  -X POST \
  -H 'Authorization: bearer xyz...xyz' \
  -F build=@'file.ipa' \
  -F 'versionName=My awesome app version' \
  -F 'tags=tag1, tag2, tag3' \
  -F 'changelog=Bug fixing' \
  -F notifyCollaborators=false \
  -F notifyEmployees=false \
  -F 'notifyMessage=Enjoy the App!' \
  -F 'deployer.name=Custom CI PLatform' \
  -F 'deployer.info.commitMessage=Fixed issue #123' \
  -F 'deployer.info.commit=f52ace0' \
  -F 'deployer.info.branch=develop' \
  -F 'deployer.info.tag=RC-1' \
  -F 'deployer.info.triggerTimestamp=1558359012580' \
  -F 'deployer.info.buildUrl=http://www.applivery.io/build/73' \
  -F 'deployer.info.ciUrl=http://www.applivery.io/ci' \
  -F 'deployer.info.repositoryUrl=https://github.com/applivery/applivery-ios-sdk' \
  -F 'deployer.info.buildNumber=173'

Responses

{  
   "status":true,
   "data":{  
      "id":"string",
      "status":"pending",
      "tags":["string"],
      "versionName":"string",
      "application":"string",
      "changelog":"string",
      "file":{  
         "originalName":"string",
         "mimetype":"string",
         "size":0,
         "bucket":"string",
         "key":"string",
         "location":"string"
      },
      "info":{  
         "icon":"string",
         "android":{  
            "targetSdkVersion":"string",
            "minSDKVersion":"string",
            "packageName":"string",
            "platformBuildVersionName":"string",
            "platformBuildVersionCode":"string",
            "versionName":"string",
            "versionCode":"string",
            "icon":"string"
         },
         "ios":{  
            "plist":{  
               "CFBundleDisplayName":"string",
               "CFBundleSupportedPlatforms":[  
                  "string"
               ],
               "MinimumOSVersion":"string",
               "CFBundleIdentifier":"string",
               "CFBundleShortVersionString":"string",
               "CFBundleVersion":"string",
               "CFBundleName":"string",
               "CFBundleIcons":[  
                  "string"
               ]
            },
            "mobileprovision":{  
               "TeamIdentifier":"string",
               "ProvisionsAllDevices":true,
               "TeamName":"string",
               "ProvisionedDevices":"string"
            }
         }
      },
      "size":"string",
      "os":"ios",
      "deployer":{  
         "name":"string",
         "info":{  
            "git_branch":"string"
         },
         "build_trigger_timestamp":"string",
         "build_url":"string",
         "app_url":"string",
         "git_repository_url":"string",
         "build_number":"string",
         "commit":"string",
         "tag":"string"
      },
      "counts":{  
         "downloads":"string"
      },
      "uploadedBy":"string",
      "createdAt":"string"
   }
}
{
    "status": false,
    "error": {
        "code": 5006,
        "message": "No File Found in request"
    }
}
{
  "status": true,
  "error": {
    "code": 2001,
    "message": "Token not valid"
  }
}
{
  "status": true,
  "error": {
    "code": 4001,
    "message": "Entity not found"
  }
}