Update a tag

The tag update request can be used to update an existing tag programmatically, instead of using AI Studio's UI (User Interface).

PUT https://api-v7.express-chat.com/inbox/tags

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>
authtype	Key

Request Body

The request body consists of a JavaScript Object Notation (JSON) object containing the fields described in the table below. Examples of the request body can be found in the Sample Requests section.

Field	Type	Description
tag	String	Current tag name to identify which tag to be updated
newTag	String	New name for updating the tag.

Responses

200 - Tag created successfully

{
  "success": true,
  "message": "Tag Updated",
  "data": {
    "_id": "6912ee67c8a7cb954e0ced96",
    "_user": "5fed38e56fb193dcc6c933f5",
    "tag": "New Example",
    "status": "ACTIVE",
    "createdAt": "2026-02-13T09:38:28.892Z",
    "updatedAt": "2026-02-13T10:36:57.239Z",
    "__v": 0
  },
  "code": 200
}

Response Fields

Root Level

Field	Type	Description
success	Boolean	Indicates whether the API request was successful.
data	Object	An object containing the newly updated tag's details

data{} (Tag Object)

Field	Type	Description
_id	String	ID of the tag record in the system.
_user	String	ID of the user who owns the tag.
tag	String	Updated tag name
createdAt	String (ISO Date)	Timestamp of when the tag was created.
updatedAt	String (ISO Date)	Timestamp of when the tag was updated..
__v	Number (Integer)	Internal versioning field.

400 - Bad Request

The <token> being used is incorrect.

{
  "success": false,
  "message": "Argument passed in must be a single String of 12 bytes or a string of 24 hex characters",
  "code": 400
}

401 - Unauthorized

Your request is missing the authtype: Key header

{
  "success": false,
  "message": "jwt malformed",
  "code": 401
}

Sample Requests

Replace <token> in the below example requests with your valid Bearer token.

curl

curl 'https://api-v7.express.com/inbox/tags' \
  -X 'PUT' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -H 'authtype: Key' \
  -d '{
    "tag": "Example",
    "newTag": "New Example"
}' \
  --compressed

❓ Got any questions?

If you have any questions, you can look into our repository of FAQs, most likely, you will find your answer here, If not, write us at [email protected].