builds

Register Build Source

Record an uploaded build context as an unbuilt build of an environment.

post/v2/builds/register

Request

Base URL: https://api.hud.ai (the document declares no server; this is the origin it was published from)
URL: https://api.hud.ai/v2/builds/register
Auth: none declared

registry_idstring uuid nullable

namestring nullable

project_idstring uuid nullable

build_idstring uuid required

external_idstring nullable

Identity of the environment in the system it is imported from, as <system>:<id>, e.g. harbor:hello-world

content_digeststring nullable

Content hash of the uploaded source; registering a digest the environment already has returns that build and discards the upload

Successful Response

idstring uuid required

registry_idstring uuid required

statusstring required

sdk_generationstring required

versioninteger nullable

uristring nullable

image_namestring nullable

digeststring nullable

content_digeststring nullable

duration_secondsinteger nullable

error_messagestring nullable

runtime_configobject nullable

source_index_status'pending' | 'indexing' | 'ready' | 'failed' | 'unavailable' required

source_index_errorstring nullable

source_index_started_atstring date-time nullable

source_indexed_atstring date-time nullable

created_atstring date-time required

updated_atstring date-time nullable

branchstring nullable

github_urlstring nullable

user_namestring nullable

scenario_countinteger nullable

Oct 9, 2026704a4fe08267 Revision changes
- ○
  the / request property's minLength was decreased from 1 to 0
Oct 5, 2026bfbeea10c39b Revision changes
- ○
  added the new optional request property
- ○
  added the new optional request property
- ○
  added the optional property to the response with the status