Sign in
Builds

post/1/builds

Request body

appIdstring required

Application id for which build is to be uploaded

changeVersionstring

Publisher/Developer internal change version (Ex: Git commit hash, Perforce CL number etc.)

fileDetailsobject

The size and name of the build file

labelstring

The label for the build

launchCommandstring

The command required to launch the build, including any parameters or flags

method'UPLOAD' | 'EXTERNAL'

One of UPLOAD, PULL or EXTERNAL

notesstring

Optional notes about the build for internal usage

buildTagsstring[]
semanticVersionstring

Semantic version for public display

scheduledReleasestring date-time nullable

Build release date in ISO-8601 format

target'GEFORCENOW' | 'GAMEREADYSERVICES' | 'GRAPHICS_DELIVERY_NETWORK' | 'UNKNOWN'

Determines how the build will be processed

pipelineIdinteger

Pipeline ID for the build

Example request

{
  "appId": "92d204f6-3aaa-4100-bc67-483e0cda2fc0",
  "changeVersion": "f78d7407",
  "fileDetails": {
    "fileName": "newbuild.zip",
    "fileSize": 1234
  },
  "label": "Debug build 12.1",
  "launchCommand": "game.exe -geforcenow",
  "method": "UPLOAD",
  "notes": "Debug build 12.1",
  "buildTags": [
    "ReleaseBuild"
  ],
  "runConfiguration": {
    "hasDrm": true
  },
  "semanticVersion": "1.0.1",
  "scheduledRelease": "2018-07-03T12:54:00",
  "target": "GEFORCENOW",
  "pipelineId": 10
}

Response

Success

Example response

{
  "data": {
    "appId": "92d204f6-3aaa-4100-bc67-483e0cda2fc0",
    "changeVersion": "f78d7407",
    "fileDetails": {
      "fileName": "newbuild.zip",
      "fileSize": 1234
    },
    "label": "Debug build 12.1",
    "launchCommand": "game.exe -geforcenow",
    "method": "UPLOAD",
    "notes": "Debug build 12.1",
    "buildTags": [
      "ReleaseBuild"
    ],
    "runConfiguration": {
      "hasDrm": true
    },
    "semanticVersion": "1.0.1",
    "scheduledRelease": "2018-07-03T12:54:00",
    "target": "GEFORCENOW",
    "pipelineId": 10,
    "id": "f9c76864-eefb-41cb-a848-443f0850968f",
    "createdBy": "123456789012345678",
    "status": "UPLOADING",
    "url": "https://s3.amazonaws.com/builds/857f0876-c7ad-4f63-86ce-1d8dd0761f2f",
    "uploadUrl": "https://cms.nvidia.com/api/1/uploads/4695df1b-1afe-42aa-bc2c-30d1aaee363f"
  },
  "_uploadConfig": {
    "accessKey": "AccessKey",
    "bucket": "builds",
    "objectKey": "builds/<uuid>/build",
    "region": "us-east-1",
    "awsSignatureVersion": "4",
    "uploadId": "002d0883-ff42-4f6f-a1ac-7b7811dcb800",
    "s3UploadCredentials": {
      "accessKeyId": "AccessKey",
      "secretAccessKey": "secretAccessKey",
      "sessionToken": "sessionToken"
    }
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.