Knowledge Center
Get familiar with Applivery and explore the features

Create a new Distribution Site under your App Store

The Upload Build request endpoint is intended to create a new Distribution Site under your App Store where to distribute your App. It supports multiple different distribution options, and security configurations.

Definition:
POST https://api.applivery.io/v1/publishedApplications

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

Param Type Description
slug String URL of the distribution site under the Store domain. E.g.: you.applivery.io/{slug}
security String Visibility of your page. Options.: public or password
password String Password to protect the Site. E.g.: $a&7%/?123
visibility String Visibility of your Site under the App Store. Options: active, inactive or unlisted
showHistory Boolean Display or not the Builds history. Options: true or false
filter.type String Filter the builds to distribute based on the information of the build itself. Useful to create multiple distribution lanes or tracks. Options.:
last: Last builds available for iOS and Android
builds: Specific build IDs (one for each OS)
tags: last build available matching matching a given set of tags
gitTag: last build available matching matching a given gitTag
gitBranch: last build available matching matching a given gitBranch
filter.value String Value to use for the filter type. E.g.: develop for gitBranch type of distribution. Only available for: tagsgitTag or  gitBranch type of distribution
filter.ios String iOS Build ID. Only available for: builds type of distribution E.g.: 552ae3cfcb5abfc58d733b81
filter.android String Android Build ID. Only available for: builds type of distribution E.g.: 552ae3cfcb5abfc58d733b82
configuration.application.name String Overwrite application name. E.g.: My awesome App
configuration.application.description String Overwrite application description. E.g.: This is my awesome App
configuration.branding.logo String Overwrite application header logo. E.g.: https://...
configuration.branding.primaryColor String Overwrite application header color. E.g.: #ffffff
configuration.branding.buttonColor String Overwrite application install button color. E.g.: #ffffff
terms.active Boolean Enable terms & conditions popup before installation E.g.: true or false
terms.text String Terms & conditions full text. E.g.: By installing this App...
showDevInfo Boolean Enable display Development info (git, certificates, etc). E.g.: true or false

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",
      "createdAt":"string",
      "application":"string",
      "slug":"string",
      "filter":{
         "type":"last",
         "value":"string",
         "ios":"string",
         "android":"string"
      },
      "security":"public",
      "tags":[
         "string"
      ],
      "visibility":"active",
      "showHistory":true,
      "terms":{
         "active":true,
         "text":"string"
      },
      "showDevInfo":true
   }
}
{
  "status": true,
  "data": {
    "code": 2001,
    "message": "Token not valid"
  }
}
{
  "status": true,
  "data": {
    "code": 4001,
    "message": "Entity not found"
  }
}