Updates an existing tag (name, access scope, and optional description) in the MessengerMate Tag Management API.
**Method & URL**
`POST https://business.me-mate.net/api/betav3/tagmanage/tag/update`
## Authentication
This endpoint expects an API key sent in the request body.
- `api_key` (string, **required**) — Use the Postman variable `{{api_key}}`.
If the API key is missing/invalid, the API will likely return **401 Unauthorized** or **403 Forbidden**.
## Required headers
- `X-Requested-With: XMLHttpRequest`
## Request body (JSON)
Send a JSON object with the following fields:
| Field | Type | Required | Description | Allowed / Validation |
| --- | --- | --- | --- | --- |
| `api_key` | string | Yes | API key used to authorize the request. | Must be valid. |
| `tag_id` | integer | Yes | The ID of the tag to update. | Must refer to an existing tag. |
| `tag_name` | string | No | Updated tag name. | If provided, should be a non-empty string. |
| `access_type` | string | No | Visibility/scope of the tag. | Enum: `private` |
| `TagDescription` | string | No | Short description for the tag. | Max length **255** characters |
### Notes / validation rules
- `TagDescription` must be **≤ 255** characters.
- `access_type` must be one of: `private`, `public`, `admin`.
- If validation fails, the API will likely return **422 Unprocessable Entity**.
## Example request
``` json
{
"api_key": "{{api_key}}",
"tag_id": 275,
"tag_name": "New Customer changed",
"access_type": "private",
"TagDescription": "Short description about the tag"
}
```
## Example success response (200)
``` json
{
"message": "Tag updated successfully",
"data": {
"tag_name": "New Customer changed",
"tag_id": 275
}
}
```
## Likely error responses
- **401 Unauthorized** — Missing/invalid `api_key`.
- **403 Forbidden** — API key does not have permission to update tags.
- **422 Unprocessable Entity** — Validation errors (e.g., invalid `access_type`, `TagDescription` > 255, missing required fields).
Headers
X-Requested-With
Request
This endpoint expects a string.
Response
OK
data
message