---
title: "POST /1/builds"
method: POST
path: "/1/builds"
tags: ["Builds"]
---

# POST /1/builds

`POST /1/builds`

## Request body

- ExpectedBuildData
  - `appId` string, required — Application id for which build is to be uploaded
  - `changeVersion` string — Publisher/Developer internal change version (Ex: Git commit hash, Perforce CL number etc.)
  - `fileDetails` object — The size and name of the build file
  - `label` string — The label for the build
  - `launchCommand` string — The command required to launch the build, including any parameters or flags
  - `method` 'UPLOAD' | 'EXTERNAL' — One of UPLOAD, PULL or EXTERNAL
  - `notes` string — Optional notes about the build for internal usage
  - `buildTags` string[]
  - `runConfiguration` RunConfiguration
    - `hasDrm` boolean — Boolean indicating if the build is protected by DRM
    - `eulaId` string — Identifier for an existing EULA record to be presented to the user at game launch
  - `semanticVersion` string — Semantic version for public display
  - `scheduledRelease` string, date-time, nullable — Build release date in ISO-8601 format
  - `target` 'GEFORCENOW' | 'GAMEREADYSERVICES' | 'GRAPHICS_DELIVERY_NETWORK' | 'UNKNOWN' — Determines how the build will be processed
  - `pipelineId` integer — Pipeline ID for the build

## Response `200`

Success

- PostReturnResponse
  - `data` BuildCreatedResponse
    - `appId` string, required — Application id for which build is to be uploaded
    - `changeVersion` string — Publisher/Developer internal change version (Ex: Git commit hash, Perforce CL number etc.)
    - `fileDetails` object — The size and name of the build file
    - `label` string — The label for the build
    - `launchCommand` string — The command required to launch the build, including any parameters or flags
    - `method` 'UPLOAD' | 'EXTERNAL' — One of UPLOAD, PULL or EXTERNAL
    - `notes` string — Optional notes about the build for internal usage
    - `buildTags` string[]
    - `runConfiguration` RunConfiguration
      - `hasDrm` boolean — Boolean indicating if the build is protected by DRM
      - `eulaId` string — Identifier for an existing EULA record to be presented to the user at game launch
    - `semanticVersion` string — Semantic version for public display
    - `scheduledRelease` string, date-time, nullable — Build release date in ISO-8601 format
    - `target` 'GEFORCENOW' | 'GAMEREADYSERVICES' | 'GRAPHICS_DELIVERY_NETWORK' | 'UNKNOWN' — Determines how the build will be processed
    - `pipelineId` integer — Pipeline ID for the build
    - `id` string — UUID for this build
    - `createdBy` string — User who created the build
    - `createdTime` string, date-time — The time of the initial upload
    - `modifiedTime` string, date-time — The last time this build was updated
    - `status` string — Current status of the build
    - `url` string — The location of the downloadable build
    - `uploadUrl` string — The URL to upload to
  - `_uploadConfig` UploadConfig
    - `accessKey` string — (Deprecated) AccessKey for evaporate.js to use
    - `bucket` string — Bucket where the image will reside in
    - `objectKey` string — Path where the image will reside in
    - `region` string — Region where the image will reside in
    - `awsSignatureVersion` string — Signature Version
    - `enableEncryption` boolean
    - `encryptionAlgorithm` string
    - `encryptionKeyId` string
    - `uploadId` string — Upload identifier
    - `s3UploadCredentials` S3UploadCredentials
      - `accessKeyId` string — AWS Access Key ID for uploading the file
      - `secretAccessKey` string — AWS Secret Access Key for uploading the file
      - `sessionToken` string — AWSSession token for uploading a file

## Other responses

- `401` — Invalid or expired token presented

---

[API](https://skmtc.dev/geforcenow/apis/nvidia-build-management-api.md) · [All operations](https://skmtc.dev/geforcenow/apis/nvidia-build-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/geforcenow/nvidia-build-management-api/revisions/d0283977ba7a/schema)