---
title: "Update a build (rename, tags)"
method: PUT
path: "/v1/builds/*id"
tags: ["Builds"]
---

# Update a build (rename, tags)

`PUT /v1/builds/*id`

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.

## Request body

- PutV1BuildsId — Update a build (rename, tags)
  - `id` string, required — Numeric build ID or string build identifier.
  - `name` string — New build identifier (capabilities.build value).
  - `tags` string[] — Replacement tag set; empty array clears all tags.

## Response `200`

Update a build (rename, tags)

- TestingbotEntitiesBuildUpdateAck — Testingbot_Entities_BuildUpdateAck model
  - `success` boolean, required — Whether the build was updated.
  - `build` object, required — The updated build: id, build_identifier and tags.

## Other responses

- `400` — Nothing to update / invalid tag
- `401` — Authentication required
- `403` — Account is read-only
- `404` — Build not found
- `409` — Another build already uses this name

---

[API](https://skmtc.net/testingbot/apis/testingbot-rest-api.md) · [All operations](https://skmtc.net/testingbot/apis/testingbot-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/testingbot/testingbot-rest-api/revisions/e95206a45b98/schema)