removeBuildLabel

Remove a custom label by key. Other labels remain unchanged. Removing a label that does not exist succeeds, so the same request can be repeated.

POST /v1/removeBuildLabel
Authorization: Bearer <access-token>
Content-Type: application/json

{ "appId": "your-app-id", "buildId": "your-build-id", "key": "github-e2e" }

All three fields are required. IDs and keys follow the same validation rules as setBuildLabel. Unknown fields are rejected. The body must not exceed 16 KiB.

The app owner or a delegate with build or release permission may remove labels, using a legacy account token or an active personal token scoped to the app.

Returns HTTP 200 with the remaining labels:

{ "appId": "your-app-id", "buildId": "your-build-id", "customLabels": {} }

A missing build returns 404, even when the requested key is absent. See getBuildLabels for the error contract.

curl -X POST "https://api.todesktop.com/v1/removeBuildLabel" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"appId":"your-app-id","buildId":"your-build-id","key":"github-e2e"}'

#removeBuildLabel

removeBuildLabel