RErender
Build Sources

Create a build source

Changed on

Create a build source that can be linked to one or more services in the same workspace.

Exactly one of git or image must be set:

  • git: the build source is git-backed. The code is built in the requested region (defaults to oregon).
  • image: the build source is image-backed. It points at an existing image in an external registry; no build is performed.

envVars, secretFiles, and envGroupIds set the build-time environment and are only valid for git sources; the request fails if any are provided with image.

post/build-sources

Request

  • Base URL
    https://api.render.com/v1
  • Auth
    HTTP bearer

Request body

ownerIdstring required
namestring required
projectIdstring
serviceIdsstring[]
envVarsSchema (unresolved $ref)
secretFilesItems[] (unresolved $ref)

Secret files for the build source's build. Only valid for git sources.

envGroupIdsstring[]

IDs of env groups to link to the build source. Only valid for git sources; env groups must belong to the same workspace and must not be scoped to an environment.

Response

Created

idSchema required(unresolved $ref)
namestring required
ownerIdstring required

ID of the workspace this build source belongs to.

projectIdstring

ID of the project this build source is scoped to, if any.

gitGit (unresolved $ref)
imageImage (unresolved $ref)
createdAtstring date-time required
updatedAtstring date-time required

Changes