Update Tag

Updates the name and/or parent of an existing tag in the authenticated account. The tag is identified by tag_uuid in the URL path. The submitted tag_name is normalized server-side before storage with the same rules as /tags/create_tag (~ -> space, runs of , -> -, Unicode control/format characters stripped, whitespace trimmed); a tag_name empty after normalization is rejected with 422. Setting a tag as its own parent is rejected with 422. If another tag in the account already has the submitted name, 409 is returned with the conflicting tag's UUID and name in data so callers can recover without a separate lookup.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

UUID of the tag to update. Must belong to the authenticated account.

Body Params
string
required
length ≤ 255

The tag's new display name. Will be normalized server-side; see endpoint description.

uuid | null

Optional. UUID of an existing tag in the authenticated account to set as parent. Pass null or omit to clear the parent. Unknown UUIDs return 422; setting the tag as its own parent returns 422.

Responses

401

Missing or invalid bearer token.

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json