---
title: "REST API: Update Tags in the Tag Group"
type: "wiki"
space: "Axero Documentation"
author: "Vladana Garic"
created: 2025-12-03T10:13:33Z
updated: 2026-02-23T03:35:22Z
url: "https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/110479/rest-api-update-tags-in-the-tag-group"
---

# REST API: Update Tags in the Tag Group

[Open API Guide](https://my.axerosolutions.com/spaces/5/axero-documentation/api-guide?id=110479)
PATCH/api/taggroups/\{GroupID\}/tags

Supports the synchronization and modification of update tags properties via the API.

## Request

### Request Header
| Header | Required | Value | Description |
| :--- | :--- | :--- | :--- |
| `Authorization` | YES | `Bearer YOUR_TOKEN` | Bearer token for the authenticated user. [Learn how to create Bearer tokens](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/108973/creating-bearer-tokens). |
| `Content-Type` | YES | `application/json` | Must be set to `application/json` |
### Required Parameters
| Parameter | Type | Required | Location | Description |
| :--- | :--- | :--- | :--- | :--- |
| `GroupID` | Integer | YES | Path | Unique identifier of the tag group you want to modify |
| `Tags JSON` | String | YES | Body | This is JSON that specifies how the tags in the group are updated. It should follow the format shown in the sample below, and the supported values are outlined below. |
### Optional Parameters
| Parameter | Type | Required | Location | Description |
| :--- | :--- | :--- | :--- | :--- |
| `addTags` | String | NO | Body | Array of tag names to add to the tag group |
| `removeTags` | String | NO | Body | Array of tag names to remove from the tag group |
| `replaceTags` | String | NO | Body | Array of tag names that overwrites all tags in the tag group. When passed, all existing tags are removed and replaced with this list. <br>Note: This parameter is applied independently and cannot be combined with addTags or removeTags. |
## Example

### Request Header

```
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
```

### Request URL

`https://your-site.com/api/taggroups/55/tags`

### Request Body

```
{
  "addTags": [
    "hr policies",
    "benefits"
  ],
  "removeTags": [
    "legacy"
  ]
}
```

### Success Response

```
{
  "IsError": false,
  "ResponseData": {
    "TagGroupID": 55,
    "TagGroupName": "Human Resources",
    "Tags": [
      {
        "TagID": 1905,
        "TagGroupID": 55,
        "TagName": "legacy",
        "EntityID": 0,
        "EntityType": 0,
        "SpaceID": 0,
        "TagWeight": 0,
        "TagCount": 0,
        "IsPromoted": false,
        "TenantID": 0
      },
      {
        "TagID": 1906,
        "TagGroupID": 55,
        "TagName": "benefits",
        "EntityID": 0,
        "EntityType": 0,
        "SpaceID": 0,
        "TagWeight": 0,
        "TagCount": 0,
        "IsPromoted": false,
        "TenantID": 0
      },
      {
        "TagID": 1907,
        "TagGroupID": 55,
        "TagName": "hr-policies",
        "EntityID": 0,
        "EntityType": 0,
        "SpaceID": 0,
        "TagWeight": 0,
        "TagCount": 0,
        "IsPromoted": false,
        "TenantID": 0
      }
    ],
    "TenantID": 0
  }
}
```

### Error Response

```
{
  "IsError": true,
  "ResponseMessage": "Required parameter is missing or invalid.",
  "ResponseData": null
}
```

## Error Handling

| Status Code | Likely Cause | Next Action |
| :--- | :--- | :--- |
| 400 Bad Request | One or more required fields are missing or invalid. \(groupId, request\) | Verify the request payload against the required parameters. |
| 401 Unauthorized | Missing or invalid Bearer token. | Check token validity. [Learn how to create Bearer tokens →](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/108973/creating-bearer-tokens) |
| 403 Forbidden | User does not have sufficient permissions. | Confirm the user has the required roles for this action. |
| 404 Not Found | The specified tag group was not found. | Verify the tagGroupID is correct. |
| 500 Server Error | Internal failure. | Retry later. |

## Rate Limits

While Axero does not enforce hard rate limits by default, we recommend the following best practices to ensure optimal performance:

- **Sustained Request Rate:** Do not exceed 5 API calls per second
- **Sequential Processing:** Wait for each request to complete before sending the next in automated workflows
- **Concurrent Connections:** If parallel processing is required, limit to 3 or fewer simultaneous requests
- **Response Timeout:** Ensure API responses complete within 15 seconds during testing

Axero may implement temporary rate restrictions if excessive API usage affects overall site performance. For high-volume integrations, contact Axero to discuss your requirements.