---
title: "Update Labels"
method: PUT
path: "/api/v1/account/labels"
tags: ["account"]
---

# Update Labels

`PUT /api/v1/account/labels`

## Request

- Base URL: `https://app.kaminari.ad`
- URL: `https://app.kaminari.ad/api/v1/account/labels`
- Auth: HTTP bearer

Replace all custom label definitions for the organization.

## Request body

- UpdateLabelDefinitionsRequest: Request body to replace all label definitions for an organization.
  - `labels` LabelDefinitionItem[], required
    - `key` string, required
    - `display_name` string, required
    - `auto_extract` boolean
    - `show_in_public_report` boolean: Show this label's value on the unauthenticated shared scan report. The PUT replaces the whole list, so omitting it hides the label.

## Response `200`

Successful Response

- LabelDefinitionResponse[]
  - `key` string, required
  - `display_name` string, required
  - `position` integer, required
  - `auto_extract` boolean, required
  - `show_in_public_report` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kaminari/apis/kaminari-ad-api.md) · [All operations](https://skmtc.dev/kaminari/apis/kaminari-ad-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kaminari/apis/kaminari-ad-api/revisions/013f86e2fd32?raw)