---
title: "Remove Agent Version Labels Route"
method: DELETE
path: "/v1/agents/{agent_id}/versions/{version}/labels"
tags: ["Agent Versions"]
---

# Remove Agent Version Labels Route

`DELETE /v1/agents/{agent_id}/versions/{version}/labels`

## Path parameters

- `agent_id` integer, required
- `version` integer, required

## Headers

- `X-Organization-Id` string
- `X-API-Key` string, required

## Request body

- LabelDeltaRequest — request body for add/remove label operations. labels: list of labels to add or remove. empty/null means no-op for add, and clear-all for remove (callers decide the semantics). override_label: when true, adding an existing label moves its association to the requested resource; when false, conflicts return 409.
  - `labels` string[], nullable
  - `override_label` boolean, nullable

## Response `200`

Successful Response

- LabelListResponse — response wrapper for just a list of labels.
  - `labels` string[]

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-10** `547d989af0ef` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/getbluejay/apis/bluejay-api/changes/v1/agents/:agent_id/versions/:version/labels/delete.md)

---

[API](https://skmtc.dev/getbluejay/apis/bluejay-api.md) · [All operations](https://skmtc.dev/getbluejay/apis/bluejay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getbluejay/apis/bluejay-api/revisions/c8f3df63307d?raw)