v50

latestOpenAPI 3.0.3raw.githubusercontent.com2025-01-2810050281.4 KB
Labels

Update a Label

Update a label for the account

patch/v1/accounts/{{account_id}}/labels/by_path/{{label_path}}

Path parameters

account_idstring required

Video Cloud account ID.

label_pathstring required

'The path for a label to update or delete. Note that the operation performed is on the last item in the path, so for example, if you specify the path /nature/birds/seabirds, only the seabirds label will be updated/deleted, but if you specify the path as /nature/birds, birds and any sub-labels of birds will be updated/deleted.'

Headers

Content-Typestring required

Content-Type: application/json

Authorizationstring required

Authorization: Bearer {access_token} - see Getting Access Tokens

Request body

new_labelstring

The new label which will replace the last item in the label path

Example request

{
  "new_label": "forest_birds"
}

Response

Label updated

pathstring

Example response

{
  "path": "/nature/mammals/seamammals"
}