e95206a45b98

latestSwagger 2.02026-08-11126123175.5 KB
Builds

Update a build (rename, tags)

Renames a build and/or replaces its tag set. Tags are short labels (letters, digits, dot, dash, underscore, colon, space; max 50 chars each, 10 per build) you can filter the builds list by (GET /v1/builds?tag=...) -- handy for marking CI runs as smoke, nightly, release-x and so on. Passing an empty tags array (JSON body) clears them.

put/v1/builds/*id

Request body

idstring required

Numeric build ID or string build identifier.

namestring

New build identifier (capabilities.build value).

tagsstring[]

Replacement tag set; empty array clears all tags.

Response

Update a build (rename, tags)

successboolean required

Whether the build was updated.

buildobject required

The updated build: id, build_identifier and tags.