awork icon

awork

Automate your workflows with the awork API

Actions110

Tag → Update Tag Globally

AI-generated

Summary

Update a tag's name and color globally across a specified parent resource type in awork, with an option to merge with an existing tag of the new name.

Inputs

  • Parent Resource (required) — The resource type to which the tag applies; one of companies, projects, tasks, or users.
  • Old Tag Name (required) — The current name of the tag to update.
  • Tag Name (required) — The new name to assign to the tag.
  • Tag Color — The new color to assign to the tag; optional selection among predefined colors.
  • Merge Existing Tags — Whether to merge with an existing tag of the new name if it already exists (boolean).
  • Request Options — Optional settings for request behaviour including batching, SSL handling, proxy, and timeout.

Output shape

a single object representing the updated tag's data as returned by the awork API

If merging is enabled and a tag with the new name exists, the tags will be merged according to awork's API behavior. The operation returns the API response, which may include updated tag properties or status information.

Links

Discussion