# Update a label

Updates the name of the matching label.

Endpoint: PUT /labels/{label_id}
Version: v4
Security: APIToken

## Path parameters:

  - `label_id` (string, required)
    Unique identifier for the resource instance.
    Example: "123456-22mpg8-dfmfi7"

## Header parameters:

  - `Content-Type` (string, required)
    Enum: "application/json"

  - `Authorization` (string, required)
    Bearer token for authentication

## Request fields (application/json):

  - `data` (object, required)

  - `data.attributes` (object, required)

  - `data.attributes.name` (string, required)
    A new name for the label.
    Example: "onboarding"

## Response 200 fields (application/json):

  - `default_asset_type` (object)

  - `default_asset_type.id` (string, required)
    Unique identifier for the resource instance.
    Example: "oqgkkd-fr5iv4-443db"

  - `default_asset_type.type` (string, required)
    The type of the resource.
    Enum: "labels"

  - `default_asset_type.attributes` (object, required)

  - `default_asset_type.attributes.name` (string)
    The name of the label.
    Example: "onboarding"

  - `default_asset_type.attributes.path` (array)
    Hierarchy of label IDs, starting with this label's ID.
    Example: ["oqgkkd-fr5iv4-443db","abc123"]

  - `default_asset_type.attributes.position` (integer)
    Label location represented by a positive integer; 0 is the first position.

  - `default_asset_type.attributes.depth` (integer)
    The depth of the label hierarchy. A root level label's depth is 1, a label with one parent has depth of 2, and so on.
    Example: 2