Update Tag Category

Before You Begin

🔗 Use the GraphQL Playground to execute the queries in this guide.

➡️ New to GraphQL? Learn how to navigate the Playground with our Playground Basics Guide.

Prerequisites

1. Authentication: Use a Service Account token (Personal Access Tokens are deprecated).
2. Permissions: Ensure your token has super admin or admin permission on the organization scope.

Step 1. Find the Tag Category UUID

Find the tag category uuid.

You can retrieve it by running this query and searching for the one you would like to update:

{
  tagCategories(organizationUuid: "organization_uuid") {
    name
    uuid
  }
}

If you don't know the uuid of the organization, you can run the following query

{
  organization(id: "<ORGANIZATION_ID>") {
    name
    uuid
  }
}

The organization ID can be found on the home page url: https://app.pipefy.com/organizations/<ORGANIZATION_ID>

Step 2: Execute the Mutation

Once you have retrieved the category tag uuid, use it to run the mutation.

mutation {
  updateTagCategory(input: {
    name: "New Name",
    uuid: "category-tag-uuid"
  }) {
    name
    uuid
  }
}

Response Fields

• name: the updated name of the tag category
• uuid: the uuid of the updated tag category

Example Response

{
  "data": {
    "updateTagCategory": {
      "name": "New Name",
      "uuid": "category-tag-uuid"
    }
  }
}